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EXECUTIVE  SUMMARY 


SNAP-PC  (Safeguards  Network  Analysis  Procedure  for  the 
Personal  Computer)  is  a  user-friendly  version  of  SNAP  designed  for 
IBM  XT  or  AT  compatible  microcomputers.  SNAP  is  a  simulation- 
based  analysis  technique  supporting  the  evaluation  of  fixed-site 
security  systems  to  prevent  theft  or  sabotage  of  a  specified 
target.  Through  SNAP  the  user  is  able  to  define  the  facility,  the 
sensor  system,  the  guard  operating  policies  and  response  tactics, 
and  the  adversary's  attack  plan. 


SNAP  uses  the  system  definition  to  analyze  its 
effectiveness  in  defending  against  specific  threats.  The  system 
performance  statistics  measured  by  SNAP  include: 


1) 

Adversary  mission  success  probability; 

2) 

Guard  and  adversary  casualties; 

3) 

Duration  of  engagements," 

4) 

Outcome  of  engagements , 

5) 

Duration  of  scenario  by  outcome 

(adversary 

success/fail),  and 

6) 

Adversary  duration  by  facility 

location. 

The  development  of  SNAP  began  in  the  late  1970's  for  use  on 
a  mainframe  computer.  The  mainframe  version  of  SNAP,  along  with 
its  graphical  model  manager,  SOS,  significantly  reduces  the  task 
of  analyzing  security  systems.  The  effort  of  putting  SNAP  on  a 
microcomputer  was  undertaken  to  place  this  aid  into  the  hands  of  a 
larger  number  of  people  who  might  not  have  the  specific  hardware 
required  by  the  mainframe  system.  In  addition,  user  support 


programs  were  developed  which  greatly  enhance  SNAP  by  providing 


efficient  model  management  and  output  analysis  capabilities  beyond 


those  provided  by  SOS. 


The  task  of  effectively  analyzing  a  security  system  requires 
significant  effort.  This  manual  deals  with  the  construction  of  a 


model  of  a  security  system  by  a  skilled  model  builder  knowledge¬ 


able  of  SNAP  analysis  techniques,  Userl.  The  actual  evaluation  of 


the  security  system  is  usually  performed  by  a  security  system 


analyst  or  on-site  C.O.  unfamiliar  with  SNAP,  User2.  This  pro¬ 


cess,  as  shown  in  the  figure  shown  below,  is  reduced  to  a  manage¬ 


able  level  by  the  SNAP-PC  support  programs 


Specify  System 
To  Be  Analyzed 


Develop  &  Test  SNAP  Model 
Using  Userl 
Support  Program 
of  SNAP-PC 


REFINE  MODEL 


Deliver  Model 
To  User 2 


(if  necessary) 


Perform  Analysis 
Using  the  User2 
Support  Program 
of  SNAP-PC 


Make  Reccomendations 
Based  on  Analysis 
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The  Userl  Support  Program  for  SNAP-PC  greatly  reduces  the 
time  previously  required  to  model  a  facility  by  providing: 

graphical  network  builders  for  the  entire  modeling  task, 
inherent  database  management  for  the  different  scenarios 
created  for  a  particular  facility, 

input  data  generators  that  automatically  prepare  the 
model  for  SNAP  analysis,  and 

capability  to  parameterize  the  model  in  such  a  way  that 
sensitivity  analysis  of  factors  such  as  patrol  force 
size,  patrolling  policies,  etc.,  can  be  performed 
without  editing  the  model. 

After  the  model  has  been  delivered  to  User2,  the  systems 
analyst  can  begin  to  evaluate  how  well  the  security  system 
performs  against  a  myriad  of  potential  attack/defense  scenarios. 
The  User2  Support  Program  eliminates  the  need  for  User2  to  deal 
with  the  large  amount  of  performance  data  generated  by  SNAP  and 
greatly  speeds  up  the  process  of  analyzing  scenarios.  In  addition 
to  the  full  capabilities  of  the  mainframe  version  of  SNAP,  it 


provides : 


inherent  database  management  for  the  collection, 
organization,  and  reporting  of  scenario  performance 
measures , 

rapid  sensitivity  analysis  through  the  use  of  a 
versatile  question-response  editor  that  can  be  used  to 
alter  patrol  force  size,  weapon  types,  etc.,  and 
on-line  animation  of  force  movements,  engagements,  and 
neutralization . 


The  SNAP-PC  package  provides  a  compact  analysis  tool  that 
can  be  used  to  analyze  a  wide  variety  of  security  systems.  It 
places  SNAP,  a  proven  evaluation  technique,  in  the  hands  of  on¬ 
site  personnel,  not  just  computer  analysts.  The  support  programs 
eliminate  the  labor  intensive  tedious  task  of  organizing  and 
sorting  through  reams  of  output  reports  and  greatly  reduce  the 
time  previously  required  to  analyze  a  security  system. 

i 
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1 . 0  INTRODUCTION/ OVERVIEW 


This  document  provides  a  detailed  explanation  of  the  use  of 
the  Userl  Support  Program  that  has  been  developed  to  aid  the  user 
in  the  building  of  SNAP  models.  This  manual  will  explain  how  to 
install  the  program  on  your  microcomputer  and  how  to  build  SNAP 
models  using  the  program.  In  addition,  it  will  explain  how  to 
prepare  models  for  execution  and  analysis  by  User 2. 

1.1  SNAP  -  History  and  References 

The  Safeguards  Network  Analysis  Procedure  (SNAP)  is  designed 
to  assist  users  in  the  evaluation  of  guard/adversary  force  engage¬ 
ments  at  fixed  sites.  Through  SNAP  symbols,  you  will  define  the 
security  system  by  outlining  both  the  physical  aspects  (buildings, 
fences,  sensors,  etc.)  and  the  procedural  aspects  (guard  patrols, 
etc.).  After  defining  the  system,  SNAP  plays-out,  or  simulates, 
an  attack  to  determine  the  likelihood  of  the  security  system 
successfully  defending  the  site.  Through  re-definition  of  the 
security  system  (i.e.,  changing  guard  patrol  procedures)  and  re¬ 
simulation  with  SNAP,  you  are  able  to  identify  possible  improve¬ 
ments  to  the  system. 

SNAP  was  developed  late  in  the  1970s  by  Pritsker  &  Associ¬ 
ates  under  contract  to  Sandia  and  the  Nuclear  Regulatory  Commis¬ 
sion.  The  first  installations  of  SNAP  included  the  evaluation  of 
nuclear  power  facilities  and  their  security  systems.  In  later 
years  SNAP  has  been  used  to  evaluate  securities  concerning  nuclear 
submarines  and  nuclear  weapon  sites. 


Further  information  on  SNAP  can  be  found  in  the  User's 
Manual  entitled  The  Safeguards  Network  Analysis  Procedure 
(SNAP):  A  User's  Manual,  listed  under  Document  Code  NUREG/CR- 
3423  or  SAND83-7123.  In  addition,  several  articles  have  been 
written  describing  SNAP  analyses.  These  are  listed  in  the  section 
' REFERENCES  1 . 

1.2  Userl  versus  User 2 

The  work  of  building  and  then  analyzing  SNAP  models  can  be 
easily  divided  between  two  user  groups,  Userl  and  User2.  Userl 
has  the  responsibility  for  developing  basic  SNAP  models  and  then 
building  those  models  using  the  Userl  Support  Program.  User2 
executes  the  models  and  performs  the  analysis.  In  our  initial 
evaluation  of  the  two  users,  Userl  should  be  knowledgeable  of  IBM- 
compatible  microcomputers  and  be  trained  in  SNAP  and  its  functions 
and  capabilities.  In  addition,  Userl  should,  to  a  limited  extent, 
be  knowledgeable  in  the  security  systems  that  are  to  be  analyzed. 
User 2  should  have  a  passing  knowledge  of  microcomputers,  an  under¬ 
standing  of  SNAP  and  its  basic  purpose,  and  a  detailed  under¬ 
standing  of  the  security  system  to  be  analyzed. 

1.3  Submodel  Breakdown 

To  aid  Userl  in  building  SNAP  models,  the  user-defined  SNAP 
model  is  broken  into  five  major  submodels.  These  are  the  Facility 
Submodel,  Control  Submodel,  Adversary  Detection  Submodel,  Guard 
Submodel,  and  Adversary  Submodel.  To  perform  a  SNAP  analysis  or 
simulation,  you  must  combine  one  of  each  of  these  submodels. 
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The  Facility  Submodel  defines  the  environment  of  the  SNAP 
analysis.  Typically,  it  identifies  buildings,  fences,  and  open 
spaces.  The  Facility  Submodel  must  identify  a  target.  The  Con¬ 


trol  Submodel  defines  the  parameters  and  status  variables  that  the 
user  wants  to  use  throughout  the  other  submodels.  The  facility's 
sensor-signal  transmission  system  is  defined  using  an  Adversary 
Detection  Submodel.  The  Guard  Submodel  outlines  the  course  of 
action  that  guards  take  during  normal  patrols.  In  addition,  it 
defines  the  response  action  guards  would  take  when  sensors  are 
triggered  or  in  some  way  an  adversary  is  detected  in  the  environ¬ 
ment.  The  adversary's  attempt  to  sabotage  or  steal  the  target  is 
defined  in  the  Adversary  Submodel. 

Userl  will  build  only  one  Facility  Submodel  and  one  Control 
Submodel  for  your  security  system.  However,  you  may  be  provided 
with  numerous  Adversary  Detection,  Guard,  and  Adversary  Submodels. 
This  will  allow  you  to  study  particular  aspects  of  your  security 
system  with  greater  ease.  For  example,  you  may  be  given  two 
Adversary  Submodels:  SOUTH  and  EAST.  The  SOUTH  scenario  might 
detail  an  adversary  attack  on  the  southern  perimeter  of  a  guard 
facility,  etc.  A  detailed  breakdown  of  the  SNAP  nodes  and  state¬ 
ments  that  is  covered  by  each  submodel  is  listed  in  Appendix  A. 

1.4  Modeling  Approach 

As  described  in  Section  1.3,  a  single  SNAP  model  contains 
five  different  submodels.  Using  the  Userl  Support  Program  you 
will  develop  these  submodels  in  a  working  space  on  your  micro¬ 
computer.  Typically,  the  first  submodel  built  is  the  Facility 
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Submodel  describing  the  environment  of  the  SNAP  analysis.  Only 
one  Facility  Submodel  is  included  in  a  working  space.  Then  it  is 
your  responsibility  to  build  the  remaining  submodels  as  necessary 
for  your  analysis. 

Since  most  of  the  submodels  are  of  a  network  nature,  the 
submodels  can  be  built  graphically  on  your  microcomputer  screen 
using  the  support  program.  Those  portions  of  the  model  that  are 
not  in  a  network  form  are  supported  by  a  forms  input.  After  these 
models  are  built,  they  are  translated  to  SNAP  input  statements  for 
later  execution  and  analysis. 

In  addition  to  building  the  SNAP  model  as  described  in  the 
SNAP  User's  Manual,  you  may  also  build  a  series  of  questions  to  be 
used  by  User 2  to  supply  necessary  data  to  prepare  the  model  for 
analysis.  For  instance,  you  may  choose  to  allow  User2  to  deter¬ 
mine  the  accuracy  of  a  sensor.  Therefore,  as  you  build  the  model 
you  will  not  want  to  supply  that  piece  of  information,  but  allow 
User 2  to  be  prompted  for  that  data.  Therefore,  in  addition  to 
building  the  five  submodels,  it  will  be  necessary  to  develop  the 
set  of  questions  that  will  be  issued  to  User 2,  the  Master  Prompt 
Query  Database.  For  each  question  in  the  Master  Prompt  Query 
Database,  you  will  specify  an  acceptable  range  of  answers  and  a 
default  answer.  The  default  answer  will  be  used  when  the  user 
does  not  wish  to  address  the  question.  The  procedure  for  creating 
a  Master  Prompt  Query  Database  is  discussed  in  Section  8.0  'GIVING 
USER2  CONTROL*.  After  building  the  submodels  and  the  Master 
Prompt  Query  Database,  it  is  suggested  that  you  thoroughly  test 
your  model  before  making  it  available  to  User2. 


As  a  beginner  you  may  wish  to  build  your  initial  model 
without  any  missing  data  which  requires  prompts  to  User2  and 
execute  the  model  in  that  state  before  adding  the  prompts.  The 
User2  manual  will  explain  the  process  of  supplying  responses  to 
the  prompts  that  have  been  identified  and  executing  the  model. 

1.5  Things  You  Should  Know 

This  manual  is  written  as  a  user-friendly  companion  to  SNAP- 
PC  and  the  Userl  Support  Program.  Each  of  the  following  sections, 
from  Section  2.0,  'INSTALLATION  OF  SNAP-PC  SOFTWARE  ON  YOUR 
MICROCOMPUTER',  through  Section  11.0,  'PREPARING  THE  MODEL  FOR 
USER2' ,  covers  an  aspect  of  using  the  Userl  Support  Program. 

Within  each  section  you  will  be  led  step-by-step  through  a 
different  stage  of  a  model  development. 


Ji 


This  section  provides  the  basic  syntax  rules  used  to 
describe  the  commands  you  will  use  and  some  of  the  basic  features 
described  on  the  menus  you  will  see  on  your  console  screen.  The 
'GLOSSARY  OF  COMMON  TERMS'  and  the  'INDEX*  at  the  back  of  this 
manual  provide  valuable  aid  in  using  this  manual  and  should  be 
reviewed  by  the  first  time  user  of  the  Userl  Support  Program. 

1.5.1  Syntax  Rules 

When  you  read  the  phrase,  enter  [USERl],  in  this  manual,  you 
are  requested  to  type  the  letters  U,  S,  E,  R,  and  1,  followed  by 
hitting  the  [RETURN]  or  [ENTER]  key  on  your  console.  The  phrase, 
type  [A],  means  you  should  hit  the  letter  'A'  key  once  and  nothing 
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else.  Certain  commonly  used  keys  will  be  abbreviated,  such  as 
[ESC]  for  the  escape  key  and  [PgUp]  for  the  page  up  key. 


1.5.2  Basic  Features  of  Menu  Screens 

The  menu  screens  printed  in  this  manual  are  actual  copies  of 
a  console  screen  that  should  differ  very  little  from  the  ones  you 
will  actually  see.  The  generic  menu  selection  screens  shown  in 
this  manual  will  be  the  same  ones  you  will  see  at  your  computer 
terminal . 

The  basic  features  of  a  Userl  Support  Program  menu  include  a 
line  of  description  across  the  top,  a  line  of  command  options 
along  the  bottom  of  the  console  screen,  and  a  title.  The 
description  tells  you  where  you  are  and  what  to  do  if  you  make  a 
mistake.  The  command  options  tell  you  how  to  move  about  the  menu 
and  what  commands  are  available  to  you.  These  are  explained  in 
more  detail  later.  Each  menu's  title,  such  as  'GUARD  SUBMODEL 
SELECTION  MENU',  uniquely  identifies  the  menu. 

When  a  menu  first  appears  on  your  screen,  the  first  line 
which  you  can  select  or  write  to  will  be  shown  in  reverse  video. 

On  the  bottom  of  the  screen  will  be  a  list  of  processing  commands 
from  which  you  may  choose.  For  example,  if  you  are  shown  a  menu 
containing  a  list,  you  may  use  the  cursor  arrow  keys  to  move  about 
the  menu  (  I  or  I  -  to  choice).  Or,  you  can  hit  the  return,  or 
enter,  key  to  select  an  entry  on  the  list  ([RETURN]).  Typing  a 
question  mark  (?  -  Help)  at  almost  any  point  in  the  Userl  Support 
Program  will  cause  a  descriptive  help  message  to  be  printed  on 
your  screen. 
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The  help  message  associated  with  each  menu  screen  printed  in 
this  manual  is  listed  on  a  page  following  the  menu  for  your 
reference . 

Hitting  the  escape  key,  [ESC],  boldfaced  on  the  top  of  your 
screen,  is  your  panic  button  when  you  make  a  mistake  and  easy-out 
when  you  get  into  a  set  of  nested  menus.  The  back  arrow  to  the 
left  of  [ESC]  on  your  screen  points  to  the  title  of  the  menu  you 
will  be  shown  if  you  type  [ESC] .  For  example,  you  may  find 
yourself  somewhere  inside  the  Adversary  Detection  Submodel  portion 
of  the  Userl  Support  Program  and  decide  you  want  to  look  at  a 
Guard  Submodel.  You  can  quickly  and  safely  retreat  back  to  the 
point  where  you  can  choose  to  look  at  the  Guard  Submodel  by  hit¬ 
ting  [ESC].  After  each  'escape'  you  will  be  pointed  to  the  next 
prior  menu,  back  to  the  first  menu  in  the  support  program. 

The  basic  panic  feature  of  [ESC]  is  good  for  morale,  but  is 
not  necessary.  The  only  permanent  damage  that  you  can  do  to  your 
data  is  to  delete  a  submodel  or  working  space.  There  is  a 
redundant,  "Are  you  sure?",  at  each  of  these  points  to  prevent  you 
from  making  a  mistake. 


// 
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2.0  INSTALLATION  OF  SNAP-PC  SOFTWARE  ON  YOUR  MICROCOMPUTER 


When  you,  as  Userl,  execute  one  of  the  support  programs 


developed  for  SNAP-PC,  you  are  actually  submitting  a  batch  job  to 


the  PC  through  DOS.  The  batch  job  executes  a  program  located  in  a 


subdirectory  on  your  fixed  disk  and  that  program,  through  the  C- 


language  ’system’  command,  calls  a  myriad  of  other  programs  based 


on  your  interactive  menu  selections. 


This  section  provides  the  specifications  for  the  micro¬ 


computer  system  that  the  SNAP-PC  programs  were  designed  to  run  on. 


the  procedure  to  install  the  SNAP-PC  programs  on  your  fixed  disk, 


and  the  miscellaneous  information  you  will  need  to  execute  the 


programs . 


2.1  Hardware  Requirements 


Table  2.1.1  lists  the  equipment  that  SNAP-PC  is  designed  to 


run  on.  Both  the  IBM  XT  and  AT  come  equipped  with  sufficient  hard 


disk  space  to  get  you  started.  If  you  are  using  your  micro¬ 


computer  for  other  work  or  you  are  planning  on  keeping  numerous 


copies  of  old  runs  on  the  disk  as  back-up,  you  will  want  to  buy  as 
much  space  as  you  can  get.  See  the  section  ’Disk  Space  Require¬ 
ments'  for  some  rough  figures  on  data  file  size. 


The  IBM  XT  is  significantly  slower  than  the  IBM  AT  and  the 


difference  is  quite  noticeable  during  a  side-by-side  comparison. 


VvV  V  V  ^  K."  ’ 


vv;,1. v.v,  -vv.vv.v.v  v,v,v  V*  *  v  v  %»>>•••  -  - 


Table  2.1.1:  Hardware  Requirements  for  SNAP- PC 

Computer 

IBM  XT  or  AT  with: 

10  megabyte  fixed  disk  (minimum) 

512k  memory  (minimum) 

80287  math  co-processor 

Monitor 

IBM  PC  Color  Monitor  (or  compatible) 

Printer 

Epson  FX80  (or  compatible) 

However,  during  the  user-interactive  portions  of  SNAP-PC 
this  difference  is  not  disruptive,  but  the  actual  simulation 
portion  of  the  program  will  run  about  three  times  faster  on  the 
IBM  AT. 

The  math  co-processor  was  made  a  requirement  because  it 
significantly  speeds  up  the  simulation  portion  of  SNAP-PC  and 
because  of  the  user-interactive  graphical  model  builders.  With 
the  co-processor  the  time  it  takes  the  model  builders  to  locate  a 
line  in  the  database  is  barely  noticeable  on  the  AT  even  in  the 
worst  of  cases . 

The  network  screens  may  be  printed  on  an  EPSON  compatible 
parallel  printer.  If  you  accidently  try  to  print  the  screens  on  a 
serial  printer  or  non-compatible  parallel  printer,  you  will  get 
undefined  results  and  will  have  to  reboot  your  system. 


2.2  Software  Requirements 


A  complete  list  of  the  software  you  will  need  to  take  full 
advantage  of  SNAP-PC  is  in  Table  2.2.1.  The  only  software  that 
you  will  need  to  get  started  that  is  not  included  in  the  SNAP-PC 
Installation  Package,  is  the  appropriate  version  of  DOS  and  a  file 
editor  such  as  WORDSTAR^. 

The  simulation  portion  of  SNAP-PC  was  written  in  FORTRAN  and 

TM 

was  compiled  using  Microsoft  FORTRAN  V3.3.  Experienced  model¬ 
lers  may  want  to  add  their  own  user  functions  as  described  in  the 
SNAP  User's  Manual.  The  procedure  for  doing  this  is  described 
under  'Adding  Your  Own  User  Code  to  SNAP-PC'. 

All  of  the  user-interactive  menus  and  graphics  are  written 
in  C-86 ,  by  Computer  Innovations,  Inc.  This  code  is  not  designed 
to  be  altered  by  the  user  and  will  not  be  discussed. 

Table  2.2.1:  Software  Requirements  for  SNAP-PC 

Operating  System:  DOS  3.0  (or  later) 

FORTRAN  Compiler:  Microsof t™F0RTRAN  V3.3 

TM 

File  Editor:  WORDSTAR  (or  compatible) 


2.3  Loading  the  SNAP-PC  Software  Diskettes 

The  diskettes  that  contain  the  SNAP-PC  software  are  high 
capacity  (1.2M)  diskettes  formatted  on  an  IBM  AT.  If  you  cannot 
list  the  directory  of  a  diskette  using  the  DOS  (DIR:)  command,  you 
will  need  to  get  another  copy.  If  you  have  a  double-sided  disk 
drive,  you  will  need  to  get  a  copy  of  SNAP-PC  on  double-sided 
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Table  2. 3. It  SNAP-PC  Software  Diskettes 


DISKETTE  ONE  -  'SNAP-PC  Executables,  Help  Screens, 

and  Example  Model* 


Subdirectory 


No.  of  Files 


SNAP\_SRC  18 
SNAP\_SRC\US_SRC  11 
SNAP\_SRC\PR  SRC  7 
snap\_src\sb"src  21 

SNAP\_SRC\CB_SRC  10 
SNAP\_SRC\AD_SRC  8 
SNAP\_SRC\NET_SRC  30 
SNAP\_SRC\FAC_SRC  4 

snap\_src\an_src  3 

SNAP\U2_USER\EX AMPLE  47 
SNAP\USER1\EX AMPLE  23 
SNAP  1 
SNAP\USER1  1 


DISKETTE  TWO  -  'SNAP-PC  SIMULATION  CODE' 

Subdirectory  No.  of_  Files 

SNAP\_SRC\SNAP_SRC  453 

Each  subdirectory  is  made  by  using  the  DOS  command  (MKDIR) . 
The  following  set  of  commands  will  construct  the  appropriate  tree 
structure: 


Table  2.3.2:  Commands  Used  to  Set  Up  the  Tree  Structure 


CD  \ 

MKDIR 

SNAP 

CD 

SNAP 

MKDIR 

USER1 

MKDIR 

SRC 

CD 

"SRC 

MKDIR 

US  SRC 

MKDIR 

PR  SRC 

MKDIR 

sb”src 

MKDIR 

CB  SRC 

MKDIR 

AD  SRC 

MKDIR 

NET  SRC 

MKDIR 

FAC  SRC 

MKDIR 

AN  SRC 

MKDIR 

SNAP  SRC 

$ 


Table  2.3.3:  Copying  Executables 


A: 

CD  \SNAP\_SRC 
C: 

CD  \SNAP\_SRC 
COPY  A:*.* 


This  diskette  also  contains  the  information  associated  with 
the  SNAP-PC  help  screens.  The  diskette  contains  subdirectories 
which  are  identical  to  the  ones  you  set  up  under  the  \SNAP\_SRC 
subdirectory.  You  must  copy  the  files  under  each  subdirectory 
from  the  diskette  to  the  corresponding  subdirectory  on  the  fixed 
disk.  For  example,  to  copy  files  for  the  US_SRC  subdirectory,  you 
should  type  these  commands: 


Table  2.3.4:  Copying  Help  Information 


A: 

CD  \SNAP\_SRC\US_SRC 
C: 

CD  \SNAP\_SRC\US_SRC 
COPY  A:*.* 


You  are  now  ready  to  load  the  software  diskettes.  The 
diskette  which  contains  the  SNAP-PC  executables,  help  screens  and 
workshops  is  loaded  first.  There  will  be  a  direct  correspondence 
between  the  subdirectories  on  the  diskette  and  the  subdirectories 
on  the  PC.  Place  Diskette  One  into  your  disk  drive  and  change  the 
directory  to  \SNAP\_SRC.  Change  the  directory  on  the  fixed  disk 
to  \SNAP\_SRC  and  copy  files  from  the  diskette.  The  following 
commands  will  accomplish  the  task: 


Follow  these  same  commands,  changing  the  subdirectory  name 
correspondingly,  for  each  of  the  other  subdirectories  on  the 
diskette. 

The  example  model  which  is  discussed  throughout  both  user 
manuals  is  also  contained  on  diskette  one.  To  load  the  model  you 
must  first  create  an  appropriate  tree  structure  for  the  model  on 
your  fixed  disk.  To  construct  this  tree  structure,  follow  the  DOS 
commands  in  Table  2.3.5. 

Table  2.3.5:  Creating  the  Tree  Structure  for  Example  Model 

CD  \SNAP 
MKDIR  U2_USER 
CD  U2_USER 
MKDIR  EXAMPLE 
CD  \SNAP\USER1 
MKDIR  EXAMPLE 


Once  the  tree  structure  is  established,  you  may  copy  the 
model  contents  from  the  diskette  into  the  appropriate  subdirec¬ 


tories  by  following  these  commands: 


Table  2.3.6:  Copying  Example  Models 


COPY  A:\SNAP\OSERS.SO_  C:\SNAP 

COPY  A:\SNAP\US  USER\FACILITY. S0_  C:\SNAP\U2_USER 
COPY  A:\SNAP\02*"USER\SUMRY$$$  .  LOG  C:\SNAP\U2\_USER 
COPY  A:\SNAP\EXAMPLE\*.*  C:\SNAP\EXAMPLE 
COPY  A:\SNAP\USERl\FACILITY.SO_  C:\SNAP\USER1 
COPY  A:\SNAP\USER1\EXAMPLE\* . *  C:\SNAP\USER1\EXAMPLE 


The  second  diskette  contains  the  source  and  object  code  for 
the  SNAP-PC  simulation  language.  Zf  you  do  not  intend  to  use  the 
user  written  support  subroutine  UP,  you  should  not  load  this 
diskette  as  the  disk  storage  requirement  is  large  for  these  files. 
The  SNAP-PC  simulation  executable  which  was  loaded  from  Diskette 
One  will  run  all  models  which  do  not  have  any  user  code.  If  you 
do  intend  to  write  user  code,  you  must  load  all  the  SNAP-PC  simu¬ 
lation  object  code,  source  file  UF.FOR,  all  of  the  include  files 
and  response  file  RESP1  from  Diskette  Two.  The  remaining  source 
code  need  not  be  loaded.  To  load,  place  Diskette  Two  into  the 
disk  drive  and  copy  the  indicated  files  into  subdirectory 
\SNAP\_SRC\SNAP_SRC.  The  commands  to  accomplish  the  task  are: 

Table  2.3.7:  Copying  SNAP-PC  Simulation  Code 

A: 

CD  \SNAP\_SRC\SNAP_SRC 
C: 

CD  \SNAP\_SRC\SNAP_SRC 
COPY  A: * . * . *OBJ 
COPY  A: UF.FOR 
COPY  A: * . * . *INC 
COPY  A:* 

For  information  on  Using  Subroutine  UF,  see  the  Section 
'Adding  Your  Own  User  Code  to  SNAP-PC'. 

2.4  Configuring  Your  Microcomputer 

To  prepare  your  PC  to  run  SNAP-PC,  you  must  include  the  DOS 
command  file  COMMAND.COM  in  your  root  directory  and  alter  two  DOS 
files,  CONFIG.SYS  and  AUTOEXEC.BAT  to  contain  certain  commands. 


If  the  files  already  exist ,  they  will  be  located  in  your  root 
directory.  There  you  must  edit  them  to  comply  with  the  required 
format  for  SNAP-PC. 

The  CONFIG.SYS  file  may  contain  up  to  eight  different 
commands  (reference  the  DOS  Manual  for  an  explanation  of  these 
commands).  In  order  to  run  SNAP-PC  four  of  these  commands  must  be 
set  as  indicated  in  Table  2.4.1. 

Table  2.4.1:  CONFIG.SYS  File  Configuration 

device  *  ansi.sys 

files  *  32 

fcbs  *  32,32 

buffers  *  10 

The  AUTOEXEC.BAT  file  is  a  file  that  DOS  looks  for  when  you 
turn  on  your  computer.  You  need  to  include  in  this  file  the 
correct  PATH  command  and  the  command  'graphics.com'. 


2.S  Disk  Space  Requirements 


SNAP-PC  executables  and  help  screen  information  require 
approximately  941K  bytes  of  disk  space.  The  executables  require 
the  bulk  of  that  space  at  877K  bytes.  If  you  load  the  files 
associated  with  adding  user  code/  it  will  require  an  additional 
400K  bytes  of  disk  space.  It  is  recommended  that  after  you  create 
the  new  SNAP-PC  simulation  executable  that  you  remove  these  addi¬ 
tional  files. 

For  each  run  that  is  made  with  SNAP-PC,  a  summary  file  is 
created  and  is  stored  on  the  disk  until  deleted.  This  file's  disk 
space  requirement  is  dependent  on  the  size  of  the  model  and  the 
amount  of  statistics  requested.  It  will  normally  range  between  9K 
and  30K  bytes.  To  limit  the  size  of  these  files,  make  sure  the 
echo  check  switch  on  the  general  run  information  statement  is  set 
to  (N)one. 

2.6  Adding  Your  Own  User  Code  to  SNAP-PC 

If  you  are  unable  to  model  your  facility  using  the  SNAP-PC 
node  symbology,  you  may  write  your  own  code  to  perform  the  desired 
logic.  The  function  UF,  which  is  contained  in  file  UF.FOR,  is 
supplied  to  interface  between  the  task  node  INVL  field  and  the 
user  code.  Before  attempting  to  write  your  code,  you  should  read 
pages  152-161  in  the  SNAP  User's  Manual.  This  section  describes 
how  the  Fur  ^tion  UF  should  be  formatted  and  the  support  routines 
which  may  be  called  from  your  code. 
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Before  you  can  write  your  user  code,  you  must  first  load  the 


required  files  from  diskette  two  into  the  subdirectory 
SNAP\_SRC\SNAP_SRC.  Follow  the  commands  in  Table  2.3.7  to  perform 

this  task. 


Function  UF  must  be  written  in  FORTRAN  and  compiled  using 
TM 

the  Microsoft  compiler  version  3.3.  Once  compiled  you  must 
create  a  new  SNAP-PC  simulation  executable  by  linking  the  simula¬ 
tion  object  code  and  the  new  UF  object  file.  This  is  simply  done  J 

by  using  the  Microsoft  link  command,  the  response  file  RESP1,  and  ’ 

* 

the  Microsoft  libraries  FORTRAN. LIB  and  MATH. LIB.  (It  is  ex-  ’ 

tremely  important  that  you  use  the  8087  version  of  the  MATH. LIB.)  j 

To  link  you  must  type  the  following  replacing  'path'  with  the 
actual  path  name  to  where  your  Microsoft  files  are  stored:  ' 


Table  2.6.1:  Creating  a  New  SNAP  Executable 
' path ' \LINK, @RESPl , SNAPEXEC/E , , ' path ' \K)RTRAN+ ' path ' \MATH  /SE:600 

Note:  MATH. LIB  must  contain  the  8087  library  of 

Microsoft  V3.3. 

If  the  link  completes  successfully,  the  file  SNAPEXEC.EXE 
will  be  created  in  the  subdirectory.  Before  executing  SNAP-PC  you 
must  move  SNAPEXEC.EXE  over  to  the  subdirectory  SNAP\_SRC.  This 
is  done  with  the  DOS  copy  command. 

Table  2.6.2:  Moving  Your  New  SNAP  Executable 

COPY  SNAPEXEC.EXE  C:\SNAP\_SRC\SNAPEXEC.EXE 
ERASE  SNAPEXEC.EXE 


i 


hi 
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When  you  copy  the  executable  over  to  the  subdirectory 
\SNAP\_SRC ,  it  will  replace  the  executable  which  already  exists.  $8$ 

Once  you  have  the  model  running  you  may  want  to  remove  the  SNAP 
object  files  from  the  PC  to  free  the  disk  space. 


3 . 0  GETTING  STARTED 


The  SNAP-PC  Userl  Support  Program  is  designed  to  be  a  user- 
friendly  interactive  model  development  aid.  To  begin  a  session, 


enter  [USERl]  on  your  terminal.  The  first  screen  displayed  is 
shown  in  Figure  3.0.1  and  allows  you  to  organize  your  models  into 
working  spaces.  A  working  space  is  a  storage  area  containing  all 


of  the  necessary  components  or  submodels  of  a  model. 


DU IT  <-  CSC 


WELCOME!  to  the  USER!  Support  Program  version  1.0. 
Pl«*«  select  the  Working  Space  on  which 
you  would  like  to  base  this  sessiont 


WORKING  SPACE  SELECTION  MENU 


•  Select  an  ex i sting  working  space 

•  List  names  and  descriptions  oi  working  spaces 

•  Delete  a  working  space 
a  Change  screen  color 

a  Quit 


t |  -  To  Choice 


CRETURN3  -  Make  Choice  7  -  Helj 


Figure  3.0.1;  Working  Space  Menu 


USER  1  PROGRAM  HELP 


The  User  1  Support  Program  la  a  menu  driven  program  that  assist*-, 
the  Type  1  User  in  developing  models  for  analysis  by  a  Type  2  User. 

Each  model  is  developed  within  a  working  space.  A  workinq  space 
can  contain  only  one  Facility  submodel  and  one  Control  submodel. 
Several  Adversary  Detection,  Guard  or  Adversary  submodels  can  be 
associated  with  the  Facility  submodel  and  the  Control  submodel 
and  hence  developed  with  one  working  space. 

The  user  can  move  about  a  list  of  options  on  the  screen  by 
hitting  one  of  the  arrow  keysi  selection  is  made  by  hittinq 
the  return  key  on  the  console.  This  menu  can  be  called  up 
at  any  time  by  typing  a  question  mark  and  then  hitting  return, 

(i .e. ,  ?  [RETURN! ) . 


CRETURN]  -  To  Continue  .  .  .MORE 


QUIT  <-  £8C 


Hitting  the  escape  key  will  take  the  user  to  the  menu  annotated 
on  the  top  right  corner  of  the  screen.  This  is  usually  the 
menu  immediately  prior  to  the  current  screen.  This  is  a  fast 
way  to  exit  or  recover  from  a  mistake. 


3.1  Initialise  a  Mew  Working  Space 


Before  you  can  begin  building  your  model,  you  must  first 
initialize  a  working  space  for  that  model. 


Figure  3.1.1:  Working  Space  Menu 

(Initialize  a  new  working  space) 


» 


I 

I 


After  you  have  chosen  to  initialise  a  model  working  space 


you  must  supply  a  name  and  description  for  the  working  space. 


WORKING  SPACE I  CREATE 


WORKING  SPACE  NAME  MENU 

Enter  a  name  for  this  working  apacei 
or  type  QUIT  to  leave  this  aenu 


MAIN  <-  CSC 


IRETURN3  -  To  Continue 


Figure  3.1.2:  Working  Space  Name 


WORKING  SPACE l  CREATE 


WORKING  SPACE  NAME  MENU 

Enter  a  line  of  description  for  the  working  spacet 


NAIM  *»  sac 


E  *  AMFt  E 


C RETURN J  -  To  Continue 


Figure  3.1.3:  Working  Space  Description 


After  supplying  a  name  and  description  for  the  new  working 
spacer  you  are  given  the  option  to  copy  an  existing  model  into 
your  new  working  space.  With  this  option  you  can  replicate  whole 
or  parts  of  models  without  the  need  to  recreate  them. 


WORKING  SPACE)  CREATE  HAIM  <-  ESC 

WORKING  SPACE  NAME  MENU 

Enter  a  line  of  description  for  the  working  spaces  .EXAMPLE 

SNAP  model  given  in  the  SNAP  User's  Manual,  Chapter  IX 


Do  you  want  to  copy  another  working  space?  ¥ES  or  NO 
C RET URN 3  -  To  Continue 


Figure  3.1.4:  Copying  an  Existing  Working  Space 


3.2  Select  an  Existing  Working  Space 


Before  you  begin  building  or  editing  an  existing  model*  you 
must  first  enter  the  working  space  you  initialized  for  the  model. 
This  is  done  by  selecting  the  option,  'Select  an  existing  working 
space* . 


QUIT  <-  CSC 

- 1 

1  WELCOME!  to  the 

1  Please  select  the 

1  you  would  like  to 

USER1  Support  Program. 
Working  Space  on  which 
base  this  session! 

•  » 

WORKING  SPACE  SELECTION  MENU 


•  Inltlilln  a  new  working  space 

IliliilPlM  •aisting  worklng  space 

•  List  names  and  descriptions  of  working  spaces 

•  Delete  a  working  space 

•  Change  screen  color 

•  Quit 


t  ♦  -  To  Choice  t RETURN ]  -  Make  Choice  ?  -  Help 


Figure  3.2.1  Working  Space  Menu 

(Select  an  existing  working  space) 


Use  the  arrow  keys  to  move  the  highlighted  block  to  the 
working  space  in  which  you  would  like  to  work  and  hit  [RETURN] 


WORKING  SPACE!  SELECT 


MAIN  <~  ESC 


WORKING  SPACE  SELECTION  MENU 


DESCRIPTION 


-  SNAP  User  '»  Manual. 

SOLUTION  Solution  to  model  BIG. 

TEST  TMi  s  is  i  test  problem  to  be  solved  in  claso 

TEST  SOL  This  is  the  solution  to  the  test  problem 

WRKSHOPS  This  is  the  work  space  which  contains  answers  to  wor  ki-hupt 
QUIT  Quit  this  menu 


t  I  - 


To  Choice 


CRE1URNJ  -  Male  Choice  '*  -  Help 


Figure  3.2.2:  Working  Space  Selection  Menu 


Figure  3.2.2a:  Working  Space  Selection  Help 


After  you  have  chosen  a  working  space  you  must  select  the 
submodel  with  which  you  would  like  to  work.  The  construction  of 
each  submodel  is  covered  in  detail  in  the  Sections  4.0  through 
7.0. 


WORKING  SPACE!  SOTS 


MAIN  <-  ESC 


Work 

with 

th* 

Work 

with 

th* 

Work 

wi  th 

th* 

Work 

wi  th 

th* 

Work 

wi  th 

th* 

Qui  t 

SUBMODEL  MENU 


control  submodel 

adversary  detection  submodels 


f  |  -  To  Choice 


t RETURN 3  -  Make  Choice  ?  -  Help 


Figure  3.2.3:  Submodel  Menu 


suit  <-  ESC 


SUBMODEL  SELECTION  HELP 


Select  the  submodel  with  which  you  would  like  to  work. 


t RETURN]  -  To  Continue 


.  DONE 


Figure  3.2.3a:  Submodel  Help 


& 
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3.3  List  Mamas  and  Descriptions  of  Working  Spaces 


You  may  review  a  list  of  the  working  spaces  that  have  been 
initialized. 


QUXTt<«.'tBC. 


WELCOME1  to  the  USER!  Support  Program  version  1.0. 
Please  select  the  Working  Space  on  which 
you  would  like  to  base  this  session: 


WORKING  SPACE  SELECTION  MENU 

•  Initialize  a  new  working  space 

•  Select  an  existing  working  space 

»  List  names  and  descriptions  of  working  spaces 

•  Delete  a  working  space 

•  Change  screen  color 

•  Quit 


♦  *  -  To  Choi  i 


CRETURN3  -  Make  Choice  ?  -  Help 


Figure  3.3.1:  Working  Space  Menu 

(List  names  and  descriptions  of  working 
spaces ) 


WORKING  SPACE 1 

LISTING  MAIN  <- 

ESC 

WORKING  SPACE  DESCRIPTIONS 

NAME 

DESCRIPTION 

1 

EXAMPLE 

Ex amp  1 e 

■facility  represented  in  SNAP  User  s  Manual. 

! 

SOLUTION 

Solution 

to  model  PIS. 

TEST 

1  hi  3  is 

a  tect  problem  to  t-e  solv=c1  in  das-: 

TES"_S0l 

Thl  3  13 

the  *30.  u\  1  o*-:  to  thn-  lest  nr  obi  err.. 

WRKSHOPS 

Th;s  13 

the  work  spact-*  wh  •  ch  coutcuns  onsKf's  to  wcrl  shcp*i. 

CRETURNJ  -  To  Continue  .  . 

.  DONE 

Figure  3.3.2 


3.4  Delete  a  Working  Space 


To  delete  a  working  apace,  select  the  option  'Delete  a 
working  apace'. 


$ 


A 


Select  the  working  space  that  you  want  to  delete  from  the 
list.  You  will  be  asked  to  verify  your  choice  before  the  working 
space  and  its  associated  model  is  deleted. 


WORKING  SPACE:  DELETING 


MAIN  <-  ESC 


NAME 


WORK  INI'.  SPACE  DELETION  MENU 
DESCRIPT  ION 


EXAMPLE  Example  facility  represented  in  SNAP  Uur'i  Manual. 

SOLUTION  Solution  to  model  BIG. 

TEST  This  is  a  te-^t  p>  ol- Jem'  to  be  id  vi  d  l  r.  c',  a -e 

TEST_SOI_  This  i  Lhe  sulu!  i  On  to  1  h=-  ti‘?t  ,)roH««. 

WRI SHOPS  This  i=  the  week  S|>ace  whtch  cont.-inf  answer  5  to  wool  shops. 

QUIT  Quit  this  menu 


|  |  -  To  Choice 


CEETURNJ  —  Male  Choice  -  Help 


Figure  3.4.2:  Working  Space  Deletion  Menu  -  Sample 


quit  t  —  esc 


WORKING  SPACE  DELETION  HELP 


Use  the  arrow  keys  to  select  the  working  space  you  ui oh  to  delete. 


IRE TURN 1  -  To  Continue 


.  .  . DONE 


Figure  3.4.2a:  Working  Space  Deletion  Help 
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3.5  Change  Screen  Color 


From  this  menu  you  may  also  change  the  color  combinations 


that  are  displayed  on  your  video  screen. 


SUIT  <-  esc 


WELCOME1  to  the  U6ER1  Support  Program  version  1.0. 
Please  select  the  Working  Space  on  which 
you  would  like  to  base  this  session) 


WORKING  SPACE  SELECTION  MENU 


•  Initialize  a  new  working  space 

•  Select  an  existing  working  space 

•  List  names  and  descriptions  of  working  spaces 

•  Delete  a  working  space 

•  Change  jscreen  color 

•  Qui  t 


f  j  -  To  Choice 


C RETURN I  -  Make  Choice  f  -  Help 


Figure  3.5.1:  Working  Space  Menu 

(Change  Screen  Color) 


QUIT  <-  ESC 


COLOR  SELECTION  MENU 


~>  yellow  on  blue 
•>  yellow  on  green 
->  magenta  on  black 
->  yellow  on  black 
->  green  on  black 
->  white  on  black 
->  cyan  on  black 


\  |  -  To  Cholca 


t RETURN!  -  Make  Choici 


Figure  3.5.2:  Screen  Color  Selection  Menu 


U. 


4.0  WORKING  WITH  THE  FACILITY  SUBMODEL 


The  Facility  Submodel  is  a  representation  of  the  facility  or 
site  under  investigation.  The  submodel  uses  SPACES,  BARRIERS,  and 
TARGETS  to  represent  the  site.  Spaces  describe  the  areas  that  are 
open  and  may  be  traversed  freely.  Barriers  represent  obstacles 
that  adversary  forces  must  penetrate  to  gain  access.  Targets  are 
locations  that  adversaries  must  reach  to  satisfy  their  objective. 
Spaces,  barriers,  or  targets  may  contain  a  sensor  which  detects 
the  presence  of  adversaries. 

The  facility  submodel  is  a  direct  translation  of  your 
site's  schematic.  Its  goal  is  to  represent  the  attributes  of 
your  facility  to  the  required  level  of  detail  while  keeping  the 
use  of  the  computer  and  analyst  resources  to  a  minimum.  The 
level  of  detail  is  determined  by  how  many  spaces  are  specified. 

The  more  spaces  you  include,  the  higher  the  level  of  detail  you 
obtain.  The  number  of  spaces  you  specify  has  a  direct  impact  on 
the  size  of  your  guard  and  adversary  submodels  as  you  must 
describe  how  your  forces  move  through  each  space. 

The  remainder  of  this  section  discusses  how  you  can  build 
and  edit  a  representation  of  your  facility  using  the  Userl 
Support  Program.  For  more  information  on  the  facility  submodel 
you  may  reference  the  SNAP  User's  Manual  pages  4  and  15-26. 

It  is  suggested  that  you  complete  the  facility  submodel  before 
attempting  to  build  the  guard  or  adversary  submodel  since  these 
refer  to  the  facility  submodel. 
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To  work  with  the  facility  submodel  choose  the  'Work  with  the 
facility  submodel'  option  from  the  'SUBMODEL  MENU'. 


WORKING  SPACE I  EXAMPLE  MAIN  <-  ESC 


SUBMODEL  MENU 

•  War k  with  the  iMsOity  submodel 

•  Work  with  the  control  submodel 

•  Work  with  the  adversary  detection  submodels 

•  Work  with  the  guard  submodels 

•  Work  with  the  adversary  submodels 

•  Quit 


■  I 


'*1/ 


Mfcl'M  i.i  M.iit  J.I  u»u»  JiOfc  . 


4.1  Create/Edit  the  Facility  Submodel 


To  create  or  edit  a  facility  submodel  select  the 


'Create/Edit  the  facility  submodel*  option. 


WORKING  SPACE I  EXAMPLE 


MAIN  <-  ESC 


facility  menu 


•  CrMte/Edit  the  facility  submodel 

•  Generate  SNAP  Input  statments  for  the  submodel 

•  Qul  t 


J  \  -  To  Choice 


C RE TURN I 


Make  Choice 


-  Help 


Figure  4.1.1:  Facility  Menu 

(Create/Edit  the  facility  submodel) 


QUIT  <-  ESC 


FACILITY  SUBMODEL  HELP 


Choose  to  enter  the  facility  submodel  builder  to  create  or  edit  thus 
facility  in  thla  working  apace;  or  generate  SNAP  input  statements 
for  the  facility  that  was  built. 


t RETURN!  -  To  Continue 


Figure  4.1.1a:  Facility  Menu  Help 
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The  first  screen  of  the  network  builder  will  appear  contain¬ 
ing  a  grid  and  command  line.  The  grid  represents  the  pages  avail¬ 
able  in  which  the  facility  may  be  drawn.  These  pages  are  identi¬ 
fied  using  the  letters  and  numbers  labelling  the  grid.  For 
example,  the  cursor  is  pointing  to  page  D,3  in  Figure  4.1.2.  The 
character,  ' will  mark  the  pages  which  already  contain  facility 
information.  You  are  not  restricted  to  fitting  the  facility  onto 
one  page.  To  select  a  page  with  which  to  work,  move  the  cursor  to 
the  desired  page  (using  the  arrow  keys)  and  type  [ENTER]. 


Facility  Page  Selection:  ARROWS  to  Move,  [ENTER]  to  select,  X  to  exit. 


Figure  4.1.2:  Facility  Page  Selection  Screen 


- a  k  n*JTm  a.  m-A  -  »  «  *  -  i  .  n.  —  r?  -  *.  -  a  »  if-  *  - 


The  contents  of  the  page  you  selected  will  appear  on  the 
screen  along  with  the  page  id  in  the  uppermost  right  corner  and  a 
list  of  available  commands  along  the  bottom.  A  detailed 
description  of  the  commands  is  listed  in  Figure  4.1.3a  and  is 
available,  on-line,  by  typing  t ? 1 . 


SNAP  Facility  Builder  Cowands:  ARSONS, C,S,B,!,l,A, 0,11, E,P,0,«, ’(help) 


Figure  4.1.3:  Facility  Builder  Page 


Description  of  SNAP  facility  Builder  Commands 


ARBORS  Move  the  crosshair  in  the  appropriate  direction. 

Crosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 

S)pace  Enter  a  space  node  at  the  current  crosshair  location. 

B)arrier  Enter  a  barrier  node  at  the  current  crosshair  location. 

Daryet  Enter  a  target  node  at  the  current  crosshair  location. 

Dine  Enter  the  line  drawing  node. 

Annotate  Enter  text  at  the  current  crosshair  location. 

Delete  Delete  the  node,  text  or  line  under  the  current  crosshair 

location.  (Confirnation  will  be  requested). 

H)ove  Enter  the  hove  node  for  the  node  or  text  under  the  current 
crosshair  location. 

E)dit  Edit  the  labels  of  the  node  under  the  current  crosshair 
location. 

P) rint  Generate  a  hardcopy  of  the  current  facility  page  on  the  printer, 

0)ptions  Select  current  display  options. 

Q) uit  Exit  fron  the  SNAP  facility  builder. 

The  ESC  key  May  be  used  to  cancel  any  connand  in  progress. 


Press  any  key  to  continue, 


Figure  4.1.3a:  Facility  Builder  Commands  Help 
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Using  the  facility  builder  (Dine  command  you  can  draw  a 
representation  of  your  facility  on  the  screen.  To  draw  a  line 
place  the  cursor  at  the  point  you  wish  the  line  to  begin  and  type 
[L],  Then  move  the  cursor  (by  using  the  arrow  keys)  in  the  direc¬ 
tion  you  wish  the  line  to  be  drawn  on  the  screen.  To  make  a  bend 
point  in  the  line,  type  [SPACE]  at  the  point  you  wish  the  bend  to 
be  and  continue  moving  the  cursor.  To  end  the  line  and  exit  the 
line  mode,  type  [ENTER]. 


Line  Node  Cowunds:  ARROWS,  C,  SPACE,  ENTER,  ESC,  ’(help) 


PACE  D  3 


Figure  4.1.4:  Line  Mode 


Description  of  Line  Mode  Commands 


ARROWS 

Crosshair 

SPACE 

ENTER 


Move  the  crosshair  in  the  appropriate  direction  and  update 
the  "rubber  band"  line  fron  the  current  origin  point  to  the 
crosshair  location.  (The  initial  origin  point  is  the  current 
crosshair  location  at  the  tine  the  line  Node  is  initiated,  but 
it  Nay  be  updated  by  the  SPACE  coNNand.  See  below.) 

Toggle  the  crosshair  speed  between  fast  and  slow. 

Make  the  current  "rubber  band"  line  permanent,  and  then 
begin  entry  of  a  new  line  with  its  origin  at  the  current 
crosshair  location. 

Make  the  current  "rubber  band"  line  perNanent,  and  then 
return  to  the  Nain  coNNand  Nenu. 


ESC 


Abort  entry  of  the  current  line  and  return  to  the  Nain 
coNNand  Nenu. 


Once  you  have  sketched  the  outline  of  your  facility,  you  may 


section  it  into  areas  and  define  them  as  spaces,  barriers,  or 
targets.  To  define  the  areas  on  the  diagram  you  place  the 
appropriate  facility  node  in  the  sectioned  area.  By  typing  [S] , 
[B],  or  [T],  you  may  place  space,  barriers,  or  targets  onto  the 
diagram.  When  you  add  a  node,  you  will  be  asked  to  supply  a  node 
label,  a  sensor  label  if  one  exists,  and  a  specification  for  node 
statistics  (Yes  or  No).  Node  labels  can  be  up  to  four  charac¬ 
ters  long. 


Figure  4.1.5:  Node  Placement 
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Description  of  Novo  Node  Commands 


ARROWS  Novo  the  crosshair  and  associated  node  or  text  in  the 
appropriate  direction. 

Crosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 

ENTER  Conplete  the  Move  connand  k  fixing  the  location  of  the 
node  or  text  associated  with  the  crosshair  at  its  current 
location.  End  Move  Mode  and  return  to  the  Main  coMMand 
Menu. 

ESC  Abort  the  current  Move  coMMand  and  return  the  node  or  text 
associated  with  the  crosshair  to  its  position  prior  to  the 
start  of  the  Move  coMMand.  End  Move  Mode  and  return  to  the 
Main  coMMand  Menu. 


Press  any  key  to  continue. 


Figure  4.1.6a:  Move  Mode  Help 
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To  delete  any  node,  line,  or  annotation  from  the  screen, 
place  the  cursor  on  the  item  you  wish  to  delete  and  type  [ D ] .  The 
item  you  selected  will  flash  and  you  will  be  requsted  to  verify 
your  selection.  To  obtain  a  paper  copy  of  the  current  page,  you 
may  use  the  print  command,  IP].  It  sends  a  copy  of  the  page  to 
any  EPSON-compatible  parallel  printer. 

You  may  change  how  your  screen  is  displayed  by  selecting  the 
display  option  [0] .  From  here  you  may  toggle  the  display  of  the 
grid,  nodes,  node  labels,  and  annotation  on  and  off.  You  also 
have  the  option  to  review  the  status  of  your  submodel. 


Display  Options:  G,  A,  N,  L,  $,  ?(help) 


Figure  4.1.8:  Display  Mode 
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Press  any  key  to  continue. 


Figure  4.1.8a:  Display  Help 
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The  status  of  the  facility  submodel  is  sectioned  into  three 
parts;  the  display  status,  showing  how  each  display  toggle  is  set; 
the  page  status,  which  shows  the  page  id  and  the  number  of  lines, 


nodes  and  annotations  on  that  page;  and  the  overall  facility 
status,  which  gives  you  the  number  of  lines,  nodes  and  annotations 
in  the  whole  facility,  along  with  the  available  memory  space  left 
for  construction.  When  you  begin  work  with  a  new  facility  sub¬ 
model,  there  are  65000  bytes  of  memory  free.  Each  line,  node,  and 
annotation  you  add  requires  a  portion  of  that  memory  and  reduces 
the  amount  available.  So  there  is  an  upper  limit  to  the  size  of 
the  facility  that  may  be  defined.  However,  it  is  very  large  and 
should  never  be  a  limiting  factor. 

Facility:  C:\SNAP\USERi\SCRATCH 


Facility  Status 

19  Lines 
15  Nodes 
2  Annotations 
57022  Bytes  Free 


Press  any  key  to  continue. 


Page  Status  Display  Status 

Page  No.  D,  3  Grid:  ON 

19  Lines  Annotation:  ON 

15  Nodes  Nodes:  ON 

2  Annotations  Node  Labels:  ON 


Figure  4.1.9;  Status  Screen 
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Once  you  have  completed  working  with  a  page,  you  may  exit  it 
by  typing  [ Q ] .  If  you  have  entered  information  on  an  empty  page, 
you  will  notice  that  a  star  1 *'  has  been  added  to  the  Facility 
Page  Selection  Screen.  You  may  continue  constructing  the  facility 
submodel  by  choosing  another  page  with  which  to  work,  or  if  you 
are  done,  you  may  exit  the  facility  submodel  builder  by  typing 
[X].  When  you  type  [X],  you  will  be  asked  whether  you  want  to 
save  the  changes.  By  typing  [Y],  the  changes  are  saved.  By 
typing  [N] ,  the  changes  are  not  saved  and  your  facility  returns  to 
its  status  prior  to  this  editing  session.  In  either  case  you  will 
return  to  the  'FACILITY  MENU'.  Typing  any  other  key  at  this  point 
will  cancel  the  exit  option  and  return  you  to  the  page  selection 
screen . 


1  2  3  4  5  6 


Facilits  Page  Selection:  Aim  to  nove,  CENTER]  to  select,  X  to  exit. 

Figure  4.1.10:  Page  Selection  Menu  After  Entering 
Information 


4.2  Generate  SNAP  Input  Statements 


After  you  have  created  your  facility  submodel,  you  may 
generate  the  SNAP  input  statements  for  the  submodel.  From  the 
'FACILITY  MENU'  choose  the  option  'Generate  SNAP  input  statements 
for  the  submodel'.  The  program  will  then  convert  your  facility 
diagram  into  SNAP  statements  and  write  them  to  a  file 
(FACILITY.NET).  This  file  will  be  in  your  working  space  sub¬ 
directory.  It  contains  the  input  data  read  by  SNAP  and  must  be 
regenerated  after  every  change  to  the  graphical  facility  submodel 


WORKING  SPACE:  EXAMPLE  'KAIN  <-  6*6 


FACILITY  MENU 

*  Create/Edit  the  facility  submodel 

*  Generate  SNAP  input  stateent*  for  th*  submodel 

*  Quit 


fl  -  To  Choice  CPE TURN]  -  MaKe  Choice  ?  -  Help 


r 


Figure  4.2.1:  Facility  Menu 

(Generate  SNAP  input  statements  for  the 
submodel ) 
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4.3  Quit 


To  exit  the  facility  submodel  section,  select  the  'Quit' 
option . 


WORKING  SPACE i  EXAMPLE 


MAIM  <-  ESC 


FACILITY  MENU 

•  Create/Edit  the  facility  aubmodel 

•  Generate  SNAP  input  atatments  tor  the  submodel 

•  Quit 


f  f  -  To  Choice  t RETURN!  -  Make  Choice  ?  -  Help 


Figure  4.3.1:  Facility  Menu 
(Quit) 


S.O  WORKING  WITR  THE  CONTROL  SUBMODEL 


WORKING  SR ACC I  EXAMPLE 


NAIM  <-  UK 


SUBMODEL  MENU 


• 

Work 

with 

th* 

4 

Mark 

with 

th* 

• 

Work 

with 

th* 

• 

Work 

with 

th* 

• 

Work 

Ml  th 

th* 

• 

Quit 

facility  aubmodal 
cwtral  MbasCal 

advaraary  datactton  aubmodal a 
guard  aubmodal  a 
advaraary  aubmodal a 


f  | -  To  Choi ca 


(RETURN!  -  «,•» #  Choi ca  -  -  Molp 


Figure  5.0.1:  Submodel  Menu 


The  control  submodel  consists  of  the  general  run  informa¬ 
tion,  the  parameter  statements  and  all  of  the  status  variable 
statements.  Since  this  submodel  contains  data  intrinsic  to  the 
other  submodels,  you  are  permitted  to  build  only  one  to  avoid 
confusion.  It  can  be  parameter i sed  to  permit  User2  to  alter 
global  variables. 


I 


5.1  Create/Edit  the  Control  Submodel 


After  you  have  chosen  to  work  with  the  control  submodel,  you 
have  two  options.  You  may  create  or  edit  the  control  submodel  or 
you  may  generate  the  SNAP  input  statements. 


i  *  AV»  A  ft  i 


Since  you  cannot  generate  SNAP  input  statements  until  you 
build  the  control  submodel,  you  must  select  the  create/edit  option 
first.  When  you  select  this  option,  a  menu  containing  the  seven 
types  of  control  statements  will  appear.  From  here  you  may  select 
the  type  of  statement  you  wish  to  create. 


USER  i  SHELL  ESC 


CONTROL  SUBMODEL  S1ATEMCN1S  MENU 

Choose  tha  statement  typa  to  craata  or  nditi 

“>  Oerter**  rm  information  etatament 
->  Parameter  statements 
->  Global  -flag  statements 
->  Global  variable  statements 
->  Force  flag  statements 
->  Auxiliary  action  macro  statements 
->  Timer  statements 
->  Quit 


♦ ♦  “  To  Choice  C RETURN!  -  Make  Choice 


Figure  5.1.2s  Control  Submodel  Statements  Menu 


quit  <-  esc 


CONTROL  SUBMODEL  STATEMENT  HELP 


Thera  are  seven  statement  types  associated  with  the  control 
submodel.  Submodels  will  not  necessarily  contain  all  of  the 
statements,  you  need  only  to  create  the  statements  associated 
with  your  own  model.  Move  the  highlighted  block  to  the 
statement  category  you  desire  to  create/edit  and  hit  C RETURN 1 . 


[RETURN!  -  To  Continue 


.  .  .  DONE 


Figure  5.1.2a:  Control  Submodel  Statements  Menu  Help 


5.1.1  General  Run  Information  Statement 


The  first  statement  on  the  menu  contains  general  run  infor¬ 


mation.  It  is  the  only  statement  that  is  required  in  the  control 


submodel . 


USER  l  SHELL  ESC 


CONTROL  SUBMODEL  STATEMENTS  MENU 


Choose  the  statement  type  to  create  or  edltt 


~>  General  run  information  statement 
->  Parameter  statements 
->  Global  flag  statements 
->  Global  variable  statements 
->  Force  -flag  statements 
->  Auxiliary  action  macro  statements 
->  Timer  statements 
->  Quit 


| |  -  To  Choice 


C RETURN!  -  Make  Choici 


Figure  5. 1.1.1:  Control  Submodel  Statements  Menu 

(General  run  information  statement) 
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When  you  originally  select  to  create  it,  a  data  input  menu 


will  be  displayed  containing  the  statement  defaults.  For  an 
explanation  of  each  field,  refer  to  the  copy  of  the  help  screens 
in  Figure  5.1.1.2a.  If  you  need  further  explanation,  you  may 
reference  the  SNAP  User's  Manual,  pages  93-95. 


Figure  5.1.1. 2:  General  Run  Statement  Menu 


I  STATEMENT  MENU  <-  ESC 

I  GENERAL  RUN  STATEMENT  MENU 

I  Simulation  and  timet  1.E20 

I  Maximum  concurrent  entities  in  myatemi  20 

I  Level  oi  echo  check  deal  red i  P 

I  Are  hlatograma  deal  red i  N 

I  Are  laciltiy  atatiatica  desiredi  N 

I  la  BATLE  output  deairedi  M 

I  Approximate  minimum  run  time  per  iteration!  0.0004 

I  Approximate  maximum  run  time  per  iteration!  100.0000 

I  ♦  )  -  To  Choice  t RETURN J  -  Make  Choice  ?  -  Help 

»  -  -  * 


/.V 
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QUIT  <-  esc 


1  GENERAL 

RUN  STATEMENT  HELP 

1  Definition 

Options 

Default 

1  Simulation  end  time 

real 

1.E20 

1  SNAP  storage  requirement 

integer 

20 

1  Echo  flag 

C-complete,  P-partial 

P 

N-none 

1  Histogram  print  flag 

V-yes,  N-no 

N 

1  Facility  statistics  option 

C-complete,  P-partial 

N 

N-none 

1  C RETURN}  -  To  Conti  nut 

.  .  .MORE 

SUIT  <-  EK 


BATLE  output  option  V-yes,  N-no  N 

Minimum  expected  run  time  raal  0.0 

par  almulatlon  iteration 
(In  mlnutas) 


Maximum  expected  run  tima  raal  1O0.0 

par  simulation  iteration 
(in  minutes) 

•mm  -  where  mm  is  a  number,  may  be  entered  in  most  fields  to  note 

parameters 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


[RETURN]  -  To  Continue 


.  .  .DONE 


Figure  5.1.1.2a:  General  Run  Information  Help 
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5.1.2  Parameter  Statements 


Parameter  statements  are  used  to  define  statistical 
distributions  that  are  used  by  the  model. 


USER!  SHELL  <-  ESC 


CONTROL  SUBMODEL  STATEMENTS  MENU 


Choofl 


-> 
_  \ 

-  > 

-•> 


ae  statement  t yp#  to  create  or  edlti 
General  run  Information  statement 

Parameter  statements 

Global  flag  statements 

Global  variable  statements 

Force  flag  statements 

Auxiliary  action  macro  statements 

Timer  statements 

Quit 


|  f  -  To  Choice 


[RETURN]  -  Make  Choice 


-  He)  p 


Figure  5. 1.2.1:  Control  Submodel  Statements  Menu 

(Parameter  statements) 


When  you  select  to  create  a  parameter  statement,  a  listing 


menu  will  be  displayed  giving  you  the  option  to  add  statements. 

The  global  flag,  global  variable,  force  flag,  and  timer  statements 
will  also  have  a  similar  listing  menu  associated  with  them. 


PARAMETER  STATEMENT  LISTING 


STATEMENT  MENU  <«  E9C 


PARAM  TARAM 

NO.  SE1  NO.  ONE 

ti  t  m-M  -  ^ 


PARAM 
I  WO 


PARAM 
I  URL  I 


f  {  -  To  Choice  A  -  ADD  D  -  DEL  I  RET  J  -  EDIT 


-  Help 


Figure  5. 1.2. 2:  Parameter  Statement  List 


ouir  <-  esc 


UIAI1MINI  til.ltci  HUP 


Arrows  move  up  or  down  tint  i  i  uiiu  Item  at  a  limp. 
PgUp  move  up  t  lit;  1  i  s.t  a  page  al  a  time. 

PgDn  •  move  down  the  1  a  page  ah  a  time. 

Home?  •  move  to  I  lie  top  of  the  1  I  «,t  . 

ImJ  move  tr*  1  tie  bottom  of  the  It  fat, 

A  •  Add  a  statement  to  list  above  torrent  line. 

D  -  Delete  statement  currently  select  ml. 

Pfc'Ulh'N  Fdlt.  statement,  currently  selected. 


(ftPVlNt’NI  lu  Clint.  Inns 


.  .  . DUMP 


Figure  5.1.2.2a:  Parameter  Statement  List  Help 
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By  typing  I  A]  a  data  input  menu  for  the  parameter  statement 
will  appear.  This  menu  allows  you  to  enter  the  data  for  a  single 
parameter  statement.  For  an  explanation  of  each  field  a  copy  of 


the  help  screens  is  given  following  the  statement  menu  figure. 

If  you  need  further  explanation,  you  can  reference  the  SNAP  User's 
Manual,  pages  ,12-14  and  74-75. 


I  STATEMENT  LIST  <-  ESC  I I 

I  PARAMETER  STATEMENT  MENU  I 
I  Parameter  set  number!  i  I 
I  Parameter  onei -**  I 
I  Parameter  twoi  0.0  I 
I  Parameter  three*  I 
I  Parameter  Tour i  0.0  I 


|  -  To  Choice  ?  -  Help 


Figure  5.1.2. 3:  Parameter  Statement  Menu 
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Once  you  have  entered  all  the  data  for  the  statement,  you 
can  save  it  by  typing  the  return  key  while  in  the  last  data  field. 
This  will  redisplay  the  statement  listing  menu.  You  can  continu¬ 
ally  add  more  statements  to  the  list  by  typing  [A].  In  addition, 
you  may  delete  [D],  edit  (type  [RETURN])  a  statement,  or  save  the 
data  you  have  entered.  The  help  screen  shown  in  Figure  5.1.2.2a 

explains  the  options  you  have  on  the  listing  menu. 
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5.1.3  Global  Fla?  Statements 


Global  flags  are  used  to  allow  you  to  control  portions  of 
the  model  by  the  status  of  a  flag.  This  statement  allows  you  to 
define  and  initialize  global  flags. 


LIBER  1  SHELL  <-  ESC 


CONTROL  SUBMODEL  3TA1EMENIR  MENU 

Choose  the  statement  type  to  create  or  pditi 

->  General  run  information  statement 
->  Parameter  statements 
->  Global  flag  statements 
->  Global  variable  statements 
->  Force  flag  statements 
->  Auxiliary  action  macro  statements 
->  Timer  statements 
->  Quit 


\  }  -  To  Choice  C RETURN!  -  Mate  Choice  -  -  Help 


Figure  5. 1.3.1:  Control  Submodel  Statements  Menu 

(Global  flag  statements) 


The  following  figure  shows  the  data  input  menu  for  the 
global  flag  statement.  This  menu  is  accessed  in  the  same  manner 
as  the  parameter  statement,  discussed  in  Section  5.1.2. 


STATEMENT  LIST  <-<ESC 


GLOBAL  FLAG  S  f A  ILMEN [  MENU 


Global  flag  label!  •• 

Initial  state  of  Global  flagi  DISABLED 


\  |  -  To  Choice 


Figure  5. 1.3. 2:  Global  Flag  Statement  Menu 


QUIT  ESC 


GLOBAL  FLAG  HELF 


Def ini t ion 


Opt  1  on* 


Flag  label 


*  character*  mar 


Initial  flag  state 


ACTIVE,  DISABELD 


D1  SABI  ED 


•» x  -  where  xx  Is  a  number,  may  be  entered  In  mo*t  field*  to  note 
parameters 

••  -  denotes  field*  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  During  this 

sessi on 


I  RETURN}  -  To  Contlnus 


Figure  5.1.3.2a:  Global  Flag  Statement  Help 


5.1.4  Global  Variable  Statements 


The  global  variable,  much  like  the  global  flag,  can  be  used 
throughout  the  model  to  control  or  effect  force  actions.  The 
global  variable  statement  defines  and  initializes  the  global 
variables . 


USER!  SHELL  <-  ESC 


CONTROL  SUBMODEL  Sl/iTEMFNlS  MENU 

Choott  the  type  to  errtte  ot  editi 

General  run  inloreatlon  atatnaeni 
->  Farameter  sLitnmnnti 
Global  4  1  eg  it  ateaentc 
->  Ilobel  verieble  itateaenti 
Force  Flag  it.tteMnti 
->  Auxiliary  «r t i on  macro  itateaento 
Timer  statements 
-  ■  Oui t 


j)  -  To  Choice  [RETURN)  -  Mole  Chnicn  -  Help 


Figure  5 . 1 . 4 . 1 : 


Control  Submodel  Statements  Menu 
(Global  variable  statement) 


l 

I 


The  Global  Variable  Statement  Menu  is  accessed  in  the  same 


manner 


as  the  parameter  statement, 


discussed  in  Section  5.1.2. 


STATEMENT  LIST  <-  E9C  I 


GLOBAL  VARIABLE  SI ATEMf  NT  MENU 
•  lotoal  laOl*  I  at)*  It  •  * 

.  »i  u*  o*  Global  vanaDlst  0. 00 


-  >t*l  n 


*  a 


i 

«r  a*  *  Menu  I 


t  «- 


5.1.5  Fores  Flag  SUttMnti 

& 

The  force  flag  serves  as  an  attribute  of  a  force  and  can  be 
used  to  control  action  in  the  sedel.  This  stataaent  supports  the 
definition  and  initialisation  of  force  flags. 


|  UOCNI  SMELL  <  IK 


CONTROL  SUBNUULl  SIAIEMtNIC  MENU 

Choose  the  statement  type  to  create  or  editi 

->  General  run  Information  statement 
->  Parameter  statements 
->  Global  flag  statements 
->  Global  variable  st a t ements 
*•>  Force  flea  statements 
->  Auxiliary  action  macro  statements 
->  Timer  statements 
->  Quit 


-  To  Choice  [RETURN 3  -  Hale  Choice 


">  -  Help 


Figure  5. 1.5.1:  Control  Submodel  Statements  Menu 

(Force  flag  menu) 
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S.l.i  Auxiliary  Action  Macro  Stataaanta 


m 


i 


When  creating  a  macro  statement,  you  must  first  supply  the 
name  of  the  new  macro.  This  is  done  by  selecting  the  create 
option  on  the  macro  name  menu. 


I  MACRO  NAMES  STATEMENT  MENU  <-  ESC  I 

I  CHOOSE  THE  MACRO  TO  EDIT  OR  CREATE  A  NEW  MACROi  1 

I  CREATE  QUIT  I 


|  | — ■»—  -  To  Choic*  CRETURN1  -  M.k.  Choice  ?  -  Help 


Figure  5. 1.6. 2:  Macro  Name  Menu 


QUIT  <-  ESC 


CREATENEDIT  MACRO  HELr 


A  macro  consists  of  a  set  of  aun  iliary  art  ions.  To  create? 
a  macro  move  th©  highlighted  bloci  to  CREATE  and  hit  [RETURN!. 
Then  enter  the  name  of  the  new  macro  in  the  data  field  which 
will  appear.  To  edit  an  existing  macro  move  highlighted 
block  to  the  desired  macro  name  and  hit  [RETURN!. 


[RETURN!  -  To  Continue 


.  .  . DONE 


Figure  5.1.6.2a:  Create/Edit  Macro  Help 
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Inter  the  new  macro  name  in  the  input  field  that  appears  on 
your  screen. 


MACRO  NAMES  B'AICMCNT  MENU  ' -  CSC 

CHOOSE  THE  MACRO  TO  EDIT  W<  O  rut  A  NEW  MACKOt 
CREATE  QUIT 


Enter  the-  n«m»  4 or  th#  m# m  eim<  rot 


|  \  -  To  Choir*  (KElUhNI  M..I  •  ltn.ii-'* 


Figure  5.1.6.3s  Entering  New  Macro  Name 
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<<  V' 


After  entering  the  name,  a  listing  menu  like  that  of  the 


parameter  statement  will  appear.  Prom  here  you  can  enter  all  of 


the  auxiliary  actions  associated  with  the  macro  in  the  same 


manner  as  described  for  the  parameter  statement.  If  additional 


help  is  needed  concerning  the  macro  statements,  you  can  reference 


the  SNAP  User's  Manual,  pages  76-77.  After  you  have  added  all  th 


auxiliary  actions,  you  can  save  the  entire  list  by  choosing  the 


save  option  on  the  listing  menu. 


•  frt  flf-H  Nr  I  in  r  f'iC 


riA<  m  i  s  ’  a  >  t  nen  i 


Avi»-  I  I  |4'  y  •  • 


I  .  i  *’  ,  sc  t  I  or*  1  alia  I  f  •• 


l  *  «u  i  I  i  ar  y  ac  t  i  'Mi  i  %  I  «  n»  r*  i 


t  I  -  To  Lhot c# 


Figure  5. 1.6.4:  Macro  Statement  Menu 


Figure  S.l.i.Oi  Macro  Halp 


5.1.7  Timer  Statements 


Tillers  are  used  to  support  statistics  collection  of  the 
length  of  time  it  takes  to  perform  a  series  of  actions.  This 
statement  supports  the  definition  of  timers. 


USCRl  SHSLL  <-  ESC 


CONTROL  SUBMODEL  S1ATEMEN1S  MENU 

Chooao  th*  itittMnt  typo  to  crti to  or  >(1111 

Gonoral  run  intorution  atatmwnt 
'  Raraaiotor  lUttMnd 
->  Global  4  1  ag  it«t*«tnti 
-v  Global  variabla  statroonta 
->  Eorco  flag  atatooonta 
- '  Auxiliary  action  aacro  atatoatonta 

»>  tint  NMMtnl* 

->  Quit 


J  $  -  To  Choi  CO  C RETURN!  -  Hal  o  Cholco  ">  -  Halp 


Figure  5. 1.7.1: 


Control  Submodel  Statements  Menu 
(Time  statement) 


The  'TIMER  STATEMENT  MENU'  is  accessed  in  the  same  manner  as 


the  parameter  statement ,  discussed  in  Section  5.1.2. 


STATEMENT  LIST  <-  ESC 


TIMER  STATEMENT  MCNU 

T l mmr  laboli  •• 

T 1  mmr  typai  TSM 
Tloor  Idtntlllfri 


♦  I  -  To  Chotca  "  -  H*lp 


Figure  5. 1.7. 2:  Timer  Statement  Menu 
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SUIT  <«  KM 


TIMER  CARD  HELP 


Definition 

>Uptl  ona 

Default 

TIMER  label 

4  charactera  max 

*• 

TIMER  type 

1 IJR  -  Time  Met  ween 

Rm  or  da 

TfiH  -  time  til  nee  Marled 
llli  -  11  mo  of  First 

RECORD 

TBM 

TIMER  Identifier 

20  c har aettr  nsme  for 
output 

bl  anl 

IRE (URN  1  -  To  Continue 

.  .  . MORE 

QUIT  <-  CMC 


■mm  -  where  mm  ia  a  numbin',  may  be  entered  tn  moat  htlds  to  note  I  | 

parameter  a  I  j 

••  -  denotea  field*  notch  cannot  be  defaulted  I  i 

ESC  -  Mill  cancel  any  changes  made  to  thla  menu  acreun  during  till*  I  i 

aeaalon  I 


(RETURN!  -  To  Continue  .  .  .DONE 


Figure  5.1.7.2a:  Timer  Statement  Help 


J 

You  may  axit  the  control  submodel  creating  and  editing  I 

session  by  selecting  the  'Quit*  option.  After  selecting  'Quit' 
you  will  be  asked  whether  you  wish  to  save  the  changes  made  to  the 
submodel . 


USER!  StCLL  <-  SSC  "l 


CONTROL  SUfcNODEL  STATEMENTS  MENU 

ChooM  th*  itattmnt  typ*  to  Croat*  or  rditi 

->  Ganaral  run  intonution  atateinant 

->  Faramatar  atatraanta 

->  Global  flag  itatruwnti 

->  Global  variabl*  atatamanta 

->  Fore*  Flag  atatamanta 

->  Aum 1 1 1  ary  action  macro  atatemrnl* 

->  Tiaar  atatamanta 

->  ealt 


J  {  -  To  Choi  ca  CRETURN1  -  Maka  Choica  -  Halp 


Figure  5. 1.8.1: 


Control  Submodel  Statements  Menu 
(Quit) 


r 


✓  / 


S.2  Generate  SNAP  Input  Statements 


® 

One*  you  have  created  all  of  your  control  atates*nts,  you 
»r«  ready  to  generate  tha  control  submodel  input  statements. 

Simply  aalact  tha  'Generate  SNAP  input  statements'  option  of 
tha  'CONTROL  MENU1  (Figure  5.1.1)  to  craata  tha  input  statements 
file.  The  file  that  is  generated  (CONTROL. CSN)  la  located  in  your 


working  space  subdirectory.  Lika  all  of  the  submodel  statement 


5.3  Quit 


To  exit 


the  control 


submodel  section, 


select  the  'Quit' 


option . 


MUH>  INB  WBCI I  (xanfxi  SUBMODEL  <-  ESC 


CUN  1  fclH  MfcNU 

•  C  Coit  t  control  tubMOflf  1 

•  « t »  I  >pv-t  *t  % 

•  iMt 


}  |  To  Choice  CRETURN3  -  •  Choice  ">  -  Help 


Figure  5.3.1:  Control  Menu 
(Quit ) 
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6.0  WORKING  WITH  THE  ADVERSARY  DETECTION  SUBMODEL 


WORKING  SPACE I  EXAMPLE 


SUBMODEL  MENU 

•  Work  with  the  facility  submodel 

•  Work  with  the  control  submodrl 

•  WaHt  with  th*  M>verAary>  detection  »ub«odele 

•  Work  with  the  guard  submodels 

•  Work  with  the  adversary  submodels 

•  Quit 


WAIN  <-  esc 


f  |  -  To  Choice 


CRETURN3  -  Make  Choici 


-  Hel  p 


Figure  6.0.1:  Submodel  Menu 


The  adversary  detection  submodel  describes  what  happens  when 
a  sensor  detects  the  presence  of  an  adversary.  The  Userl  support 
program  allows  you  to  'draw'  the  Adversary  Detection  Diagram  and 
fill  in  pertinent  information  on  a  menu  screen  and  then  generate 
the  SNAP  input  file.  Using  it,  you  can  create  multiple  submodels 
and  parameterize  them  for  User 2. 

When  you  are  ready  to  create  an  adversary  detection  submodel 
for  a  facility,  choose  the  option  'Work  with  the  adversary  detec¬ 
tion  submodels'  from  the  'SUBMODEL  MENU'. 


6.1  Create  an  Adversary  Detection  Submodel 


The  'ADVERSARY  DETECTION  MENU'  will  then  be  displayed  giving 
you  several  options.  An  explanation  of  these  options  is  shown  in 
Figure  6.1.1a.  To  create  an  adversary  detection  submodel,  you 
must  select  the  create  option  on  the  menu. 


Figure  6.1.1:  Adversary  Detection  Menu 

(Create  an  adversary  detection  submodel) 


ADVERSARY  DETECTION  HELP 


•HIT  <~  WC 


Choose  to  an tar  tha  network  builder  by  creating  or  editing  an 
adversary  detection  submodel .  In  addition,  from  this  menu  you 
may  translate  network  symbols  Into  SNAP  Input  statements  for  a 
submodel,  list  or  delete  submodels. 


I  t RETURN 3  -  To  Continue 


.DONE 


The  first  screen  of  the  network  builder  will  then  appear 


containing  a  grid  and  a  command  line.  The  grid  represents  the  48 
pages  that  can  be  used  to  construct  the  submodel.  These  pages  are 
identified  by  the  letters  and  numbers  bordering  the  grid.  For 
example,  the  cursor  is  in  Page  D, 3  in  Figure  6.1.2.  The  character 
will  mark  the  pages  which  currently  contain  adversary  detec¬ 
tion  submodel  information.  You  can  move  the  cursor  around  the 
grid  by  using  the  arrow  keys  and  select  the  page  in  which  you  are 
interested  by  hitting  the  return,  or  enter,  key. 


ARROHS 


CENTER] 


(F)ind 


(C)heck 


Description  of  Display  Control  Commands 

Hove  cursor  from  box  to  box  on  the  screen.  Each  box 
is  associated  with  a  page  on  which  the  network  way 
way  be  drawn. 

Hitting  ENTER  selects  the  page  associated  with  the  box 
that  the  cursor  is  in. 

Search  the  network  for  a  node  entered  fron  the  terninal. 
The  page  on  which  the  node  occurs  will  be  returned  if 
it  is  found. 

Check  if  all  nodes  in  the  network  have  been  filled, 
ft  list  containing  the  label  and  location  of  the  nodes 
that  have  not  been  filled  will  be  shown  on  the  screen. 


(H)elp  Prints  this  information  to  the  screen. 
eOOit  Causes  the  prograw  to  terminate. 


Press  any  key  to  continue, 


Figure  6.1.2a:  Adversary  Detection  Submodel  Network  Builder 
Page  Selection  Screen  Help 
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One*  you  have  selected  the  page  with  which  you  deaire  to 
work,  the  contenta  of  that  page  will  be  diaplayed  on  the  screen. 
The  page  id  will  appear  in  the  uppermost  right  corner  and  a  list 
of  options  along  the  bottom  of  the  screen.  The  commands  are 
described  on  the  help  screen,  which  is  listed  on  the  next  page. 


Description  of  SNAP  Adversary  Detection  Device  Builder  Comands 


ARROWS 

Orosshair 

G)oto 

S)ensor 

B) ranch 

F)ill 

L) ogic 
Mo(N)itor 

D) elete 

M) ove 

E) di  t 

P) rint 
Options 

Q) ui  t 


Enter  a  SENSOR  node  at  the  current  crosshair  location. 

Enter  the  branch  drawing  node. 

Fill  node  Menu  at  current  crosshair  location. 

Enter  a  LOGIC  node  at  the  current  crosshair  location. 

Enter  a  MONITOR  node  at  the  current  crosshair  location. 

Delete  current  item.  (Conf irnation  will  be  requested). 

Move  the  node  or  text  at  the  current  crosshair  location. 

Edit  the  node  under  the  current  crosshair  location. 

Generate  a  hardcopy  of  the  current  facility  page  on  the  printer. 
Select  current  display  options. 

Quit  this  page  of  the  SNAP  network  builder. 


The  ESC  key  nay  be  used  to  cancel  any  coMMand  in  progress. 


Press  any  key  to  continue. 


Figure  6.1.3a:  Adversary  Detection  Network  Builder  Help 


When  a  sensor  detects  the  presence  of  an  adversary,  it 
transmits  a  signal  to  the  guard  force  that  is  waiting  for  the 
signal.  Along  its  transmission  path,  the  signal  may  be  inter¬ 
rupted  at  junction  loops  or  switches.  To  prevent  this,  other 
sensors  (tamper  alarms)  can  be  associated  with  any  detection 
device.  These  tamper  alarms  will  alarm  if  the  detection  device  is 
disabled.  The  signal  is  also  subject  to  logical  confounding.  In 
other  words,  the  monitor  may  be  able  to  tell  that  some  detection 
device  has  alarmed,  but  cannot  identify  which. 

These  aspects  of  the  adversary  detection  submodel  are 
described  graphically  using  the  Adversary  Detection  Diagram. 
SNAP-PC  allows  you  to  interactively  'draw'  the  diagram.  (S)ensor 
nodes  are  represented  using  circles;  (L)ogic  points,  the  junction 
boxes  or  switches,  are  squares;  and  triangles  are  mo(N)itors.  The 
transmission  paths  are  represented  by  solid  lines,  (B) ranches, 
between  the  symbols,  or  nodes. 

To  add  a  node  to  the  diagram,  position  the  cursor  to  where 

you  would  like  the  node  placed  and  then  type  the  letter  associated 

with  the  node.  You  will  be  asked  to  enter  a  node  label  (4  charac¬ 
ters  maximum) .  The  node  symbol  and  its  label  will  then  be  dis¬ 

played  on  your  screen. 
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Mem 


Commands :  ARItOUS,C,N<L,S<GJB,F,A,D,M,EJPJ0,«l?(help) 


Figure  6.1.4:  Node  Placement 
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To  show  the  path  a  signal  takes  through  a  detection  sub¬ 
model,  the  nodes  are  connected  by  (B) ranches.  A  branch  is  created 
by  placing  the  cursor  at  the  desired  beginning  point  of  the  branch 
and  then  typing  [B].  The  branch  is  drawn  as  you  move  the  cursor 
around  the  page.  A  bend  point  in  the  branch  can  be  drawn  by 
typing  [SPACE]  and  continuing.  To  end  the  branch  you  type 
[RETURN] . 


Branch  Node  CoMands!  ARROWS,  C,  SPACE,  ENTER,  ESC,  H(elp) 


Figure  6.1.5:  Branch  Mode 


r*. 


Description  of  Branch  Node  Commands 


ARROWS  Hove  the  crosshair  in  the  appropriate  direction  and  update 
the  "rubber  band"  branch  from  the  current  origin  point  to  the 
crosshair  location.  (The  initial  origin  point  is  the  current 
crosshair  location  at  the  tine  the  line  Mode  is  initiated,  but 
it  May  be  updated  by  the  SPACE  coMMand.  See  below.) 

Crosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 

SPACE  Hake  the  current  "rubber  band"  branch  pernanent.  and  then 
begin  entry  of  a  new  branch  with  its  origin  at  the  current 
crosshair  location. 

ENTER  Hake  the  current  "rubber  band"  branch  pewanent,  and  then 
return  to  the  Main  coMMand  Menu. 

ESC  Abort  entry  of  the  current  branch  and  return  to  the  Main 
coMMand  Menu, 


Press  any  key  to  continue. 


Figure  6.1.5a:  Branch  Mode  Help 


l  .m  ' j.<  ^ *»< 


When  the  submodel  is  too  big  to  fit  onto  one  page,  you  can 
use  the  (G)oto  node  to  connect  pages.  The  node  label  of  the  goto 
node  is  the  same  as  the  node  it  connects  to.  You  can  see  the  use 
of  the  goto  node  below  as  it  connects  the  branch  from  sensor  SEN 3 
to  monitor  M0N1  on  page  D,4.  You  can  have  multiple  goto  nodes 
connecting  to  the  same  node. 


GED2 


Comands:  ARROWS, 


Figure  6.1.6:  The  Goto  Node 


To  add  clarity  to  your  diagram  you  may  enter  text  by  using 
the  (A)nnotation  command.  It  allows  you  to  enter  one  line  of 
text  and  place  it  at  the  current  position  of  the  cursor. 


Description  of  Fill  Node  Commands 


ARROWS  Hove  the  crosshair  in  the  appropriate  direction. 

Crosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 

ENTER  Enter  the  fill  Menu  of  the  node  which  is  positioned 
at  the  current  location  of  the  crosshair.  This  allows 
user  to  fill  in  the  data  associated  with  the  node. 

ESC  Quit  the  fill  command  and  return  to  the  main  option 
Menu. 


Press  ang  key  to  continue. 


Figure  6.1.8a:  Fill  Mode  Help 
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SENSOR  NODEt  82 


NCTMORK  <-  ESC 


SENSOR  NODE  MENU 
Probability  of  detectioni  ,I«Q 
Signal  paraistancai  PERMANENT 

Entar  SAVE  to  aava  currant  valuaa,  QUIT  to  ax  it  without  saving i 


\ |  -  To  Cholca  ?  -  Halp 


Figure  6.1.9:  Sensor  Node  Menu 


suit  <«•  cse 


SENSORS  STATEMENT  HELP 


Definition  Option*  Default 


Pr°t>abtlity  of  detection  constant  between  *ero  1.0 

and  one  or  a  global 
variable 

Signal  persistence  TEMPORARY,  PERMANENT  PERMANENT 


•xx  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 

parameters 

•  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


t RETURN]  -  To  Continue  .  .  .DONE 


Figure  6.1.9a: 


Sensors  Statement  Help 
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MONITOR  NODE l  Ml 


NETWORK  <-  ESC 

MONITOR  NODE  MENU 
List  guard  WAIT  nods*  to  signal  I 
* 

4s  'r'  '  •  vSS#  .  :  •  %<  .  S,v  ■>  .  '  r  '  '■ 

Entsr  SAVE  to  savf  current  values,  QUIT  to  exit  without  saving: 


| |  -  To  Choice 


-  Help 


Figure  6.1.10:  Monitor  Node  Menu 


suit  <-  etc 


MONITORS  HELP 


Options 


Def  au 1 1 


Definition 


List  of  guard  WAIT  node  labels 


Ex m  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 

parameters 

•  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


t RETURN J  -  To  Continue 


.  . DONE 


Figure  6.1.10a:  Monitors  Help 


To  aid  in  the  construction  of  the  adversary  detection 
submodel,  there  are  several  support  options  available.  You  may 
(Eldit,  [Olelete,  or  IMJove  objects  on  the  page.  You  may  change 
the  screen  display  lOlptions  and  check  the  status  of  the  network 
builder.  Or  you  may  print  a  copy  of  the  page  to  your  EPSON- 
compatible  printer. 

The  delete  option  allows  you  to  remove  a  node,  branch,  or 
text  from  the  diagram.  Simply  place  the  cursor  at  the  location  of 
the  object  you  wish  to  delete  and  type  [D].  As  a  safety  precau¬ 
tion,  the  object  you  are  about  to  delete  will  flash  and  you  will 
be  asked  to  verify  your  choice. 

If  you  wish  to  change  the  node  label  of  a  node,  just  place 
the  cursor  on  the  desired  node  and  type  [E] .  You  will  then  be 
asked  to  enter  the  new  node  label. 

To  get  a  hard  copy  of  your  diagram  you  may  use  the  (P)rint 
option.  By  typing  [P]  you  can  get  a  copy  of  the  current  page. 


You  may  move  a  node  or  text  around  a  page  by  placing  the 
cursor  on  the  object  you  wish  to  move  and  typing  t M] .  The  object 
you  selected  will  flash  and  will  follow  the  cursor  as  you  move 
about  the  page.  Type  [RETURN]  to  fix  the  object  in  its  new  loca¬ 
tion  or  type  [ESC]  to  return  the  object  to  its  original  location. 


m 


description  of  Hove  Node  CoMMands 


ARROWS  Hove  the  crosshair  and  associated  node  or  text  in  the 
appropriate  direction. 

Crosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 

ENTER  Complete  the  Move  command  by  fixing  the  location  of  the 
node  or  text  associated  with  the  crosshair  at  its  current 
location.  End  nove  node  and  return  to  the  Main  coMMand 
Menu. 

ESC  Abort  the  current  Move  coMMand  and  return  the  node  or  text 
associated  with  the  crosshair  to  its  position  prior  to  the 
start  of  the  Move  coMMand.  End  Move  Mode  and  return  to  the 
Main  coMMand  Menu. 


Press  any  key  to  continue. 


Figure  6.1.11a:  Move  Mode  Help 


By  typing  [0]  you  can  enter  the  display  (Option  mode.  You 
can  toggle  the  display  of  the  grid  points,  the  annotation,  and  the 
SNAP  labels.  You  may  also  check  on  the  status  of  the  adversary 
detection  submodel  network  builder  by  the  [SJtatus  option.  An 
example  of  a  status  report  for  the  facility  submodel  network 
builder  is  shown  in  Figure  4.1.9  and  is  explained  in  Section  4.1. 


Description  of  Display  Option  CoMMands 

G)rid  Toggle  the  grid  display  on  or  off. 

Annotation  Toggle  the  display  of  annotation  on  or  off. 

Dahel  Toggle  the  display  of  SNAP  node  labels  on  or  off. 

Sltatus  Display  a  report  on  the  status  of  the  display  options, 
status  of  the  current  display  page  and  status  of  the 
overall  facility, 

All  display  option  connands  return  to  the  nain  connand  Menu  upon  coapletion. 


Press  any  key  to  continue. 


Figure  6.1.12a:  Display  Options  Help 


mmmmA 


Once  you  have  completed  a  page  you  can  exit  from  it  by 
typing  IQ].  The  display  control  menu  will  then  be  displayed, 
asterisk  indicates  what  pages  have  been  used  to  construct  the 


submodel . 

1  2  3  4  5  6 

A 

B 

C 

D 

E 

F 

G 

H 


comm:  ARROWS,  [ENTER],  <F)ind,  (Oheck,  tflOit,  <?)help 

Figure  6.1.13:  Display  Control  Menu  After  Constructing 
Network 
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To  help  verify  that  you  have  supplied  all  the  data  required, 
you  may  (C)heck  the  network  for  unfilled  nodes  by  typing  [C] .  The 
program  will  then  give  you  a  listing  of  all  the  nodes  that  have 
been  drawn  but  not  filled. 

A 
B 
C 
D 
l 
F 
G 
H 


Node  SI,  on  page  D,  3  has  not  Been  filled.  Hit  a  keg  to  continue. 


Figure  6.1.14:  Check  Option 


If  you  are  interested  in  editing  a  node  and  you  do  not  know 


which  page  contains  the  node,  you  may  (F)ind  it  by  typing  [F]. 

You  will  then  be  asked  for  the  node  label.  After  entering  the 
label  the  program  will  return  with  the  page  number  containing  the 
node.  If  the  label  is  associated  with  a  goto  node,  several  loca¬ 
tions  for  the  node  may  appear. 


Node  label?  I 


Figure  6.1.15:  Find  Option 
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When  you  are  ready  to  exit  the  adversary  detection  submodel 
network  builder,  you  may  type  [X].  A  screen  will  appear  giving 
you  the  option  to  save  the  submodel  or  quit  without  saving.  By 
entering  a  name,  the  submodel  will  be  saved  and  will  be  identified 
by  that  name.  You  may  then  enter  a  description  for  the  submodel. 
After  entering  a  description,  you  will  return  to  the  'ADVERSARY 
DETECTION  MENU'. 


WORKING  SPACE 1  EXAMPLE  MAIN  <-  E9C 


ADVERSARY  DETECTION  SUBMODEL  FILE  NAME  MENU 

Enter  a  name  for  this  filai  DET2 

or  type  QUIT  to  leave  this  menu 


C RETURN]  -  To  Continue 


WORKING  SPACE l  EXAMPLE 


MAIN  <-  CSC 


Figure  6.1.17:  Adversary  Detection  Submodel  Description 
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6.2  Edit  an  Adversary  Detection  Submodel 


If  you  wish  to  change  an  existing  adversary  detection  sub¬ 
model,  select  the  edit  option  on  the  adversary  detection  menu. 


WORKING  SPACE I  EXAMPLE 


susHJPtu  <~tac 


ADVERSARY  DETECTION  MENU 


•  Craata  an  adversary  detection  submodel 

•  •  Edit '  «A:  Wver««ry  detection  submodel 

•  Generate  SNAP  input  statements 

•  List  adversary  detection  submodels 

•  Delete  an  adversary  detection  submodel 

•  Quit 


f  f -  To  Choice 


C RETURN 3  -  Make  Choice  ?  -  Help 


Figure  6.2.1:  Adversary  Detection  Menu 

(Edit  an  Adversary  detection  submodel) 


After  you  select  the  submodel  you  wish  to  edit  from  a  list 


of  those  that  you  have  created,  Figure  6.2.2,  you  will  re-enter 


the  adversary  detection  submodel  network  builder.  When  you  exit 


the  network  builder  after  your  edit  session,  you  may  save  the 


changes  under  the  current  name,  create  a  new  file,  or  overwrite  an 


existing  file  by  entering  the  name  of  an  existing  file. 


m 


B 
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WORKING  SPACE  I  EXAMPLE 


MAIN  <-  ESC 


ADVERSARY  DETECTION  SUBMODEL  SELECTION  MENU 
DESCRIPTION 


BET  I  submodel  with  only  on*  **r»*or 

DET2  dot *ctlon  submodel  with  throe  iinfori 

QUIT  Quit  this  menu 


To  Choice 


[RETURN!  -  Hake  Choice  ?  -  Help 


Figure  6.2.2:  Adversary  Detection  Submodel  Selection  Menu 


quit  <-  esc 


ADVERSARY  DETECTION  SUBMODEL  SELECTION  HELP 


Use  the  arrow  keys  to  select  the  adversary  detection  submodel  with 
which  you  want  to  work. 


[RETURN!  -  To  Continue 


.  .  . DONE 


Figure  6.2.2a:  Adversary  Detection  Submodel  Selection  Help 
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6.3  Generate  SNAP  Input  Statements 


You  may  generate  the  SNAP  input  statements  for  any  of  the 
adversary  detection  submodels  you  have  created.  Select  the 
'Generate  SNAP  input  statements'  option  on  the  'ADVERSARY 
DETECTION  MENU ' ,  Figure  6.3.1.  You  may  then  choose  from  a  list  of 
the  names  of  the  submodels  that  you  have  built.  The  file  that  is 
generated  ('name'.DSM)  is  located  in  your  working  space 
subdirectory. 


WORKING  SPACE  I  EXAMPLE  SUBMODEL  <~C8C 


ADVERSARY  DETECTION  MENU 

•  Create  an  adversary  detection  submodel 

•  Edit  an  adversary  detection  submodel 

•  List  adversary  detection  submodels 

•  Delete  an  adversary  detection  submodel 

•  Quit 


f  4  “  To  Choice  C RETURN J  -  Make  Choice  ?  -  Help 


Figure  6.3.1: 


Adversary  Detection  Menu 
(Generate  SNAP  input  statements) 
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6.4  List  Adversary  Detection  Submodels 

The  list  option  will  display  the  name  and  description  of  all 
the  current  adversary  detection  submodels. 


ADVERSARY  DETECTION  MENU 


*  Create  an  adversary  detection  submodel 
»  Edit  an  adversary  detection  submodel 

*  Generate  SNAP'  input  statements 

»•  Liet  edvereary  detection  eubmodeie 

*  Delete  an  adversary  detection  submodel 

*  Quit 


6.5  Delete  an  Adversary  Detection  Submodel 


If  you  wish  to  delete  a  submodel ,  select  the  'Delete  an 
adversary  detection  submodel'  option.  Then  select  the  submodel 
you  wish  to  delete  from  the  displayed  list.  You  will  be  asked  to 
verify  your  choice. 


WORKING  SPACE I  EXAMPLE 


ADVERSARY  DETECTION  MENU 

•  Create  an  adversary  detection  submodel 

•  Edit  an  adversary  detection  submodel 

•  Generate  SNAP  input  statemonts 

•  List  adversary  detection  submodels 

•Delete  an  adversary  detection  submodel 

•  Quit 


|  |  -  To  Choice  CRETURN1  -  Make  Choice  ?  -  Help 


SUBMODEL  v-ESC 


Figure  6.5.1:  Adversary  Detection  Menu 

(Delete  an  adversary  detection  submodel) 


Figure  6.5.2a:  Adversary  Detection  Submodel  Deletion  Help 


€.6  Quit 


To  exit  the  adversary  detection  submodel  section,  select  the 
‘Quit*  option. 

It  is  important  to  remember  that  you  can  build  multiple 
adversary  detection  submodels  for  one  facility  and  that  each 
submodel  is  identified  with  a  name,  given  it  at  the  time  of 
creation.  You  always  have  the  option  of  editing  any  submodel  at 
anytime . 


WORKING  SPACE!  EXAMPLE  SUBMODEL  <-EBC 


ADVERSARY  DETECTION  MENU 

•  Create  an  adversary  detection  submodel 

•  Edit  an  adversary  detection  submodel 

•  Generate  SNAP  input  statements 

•  List  adversary  detection  submodels 

•  Delete  an  adversary  detection  submodel 


t  \  -  To  Choice  C RETURN]  -  Mal  e  Choice  -  Help 


Figure  6.6.1s  Adversary  Detection  Menu 
(Quit) 


7.0  WORKING  WITH  THE  GUARD  AND  ADVERSARY  SUBMODELS 


The  guard  submodel  is  used  to  describe  the  movement  of  guard 
forces  through  a  facility.  It  represents  the  normal  patrol  route 
of  guard  forces  and  the  movement  of  the  forces  when  adversaries 
are  detected.  The  submodel  also  describes  how  auxiliary  guard 
forces  react  to  an  adversary  attack.  You  may  construct  multiple 
guard  submodels  to  represent  different  patrol  and  defense  plans. 
Each  submodel  can  be  parameterized  to  allow  User 2  to  perform 
sensitivity  analysis  on  certain  variables. 

The  adversary  submodel  describes  the  attack  logic  of  the 
adversary.  For  instance,  an  adversary  force  may  sneak  into  a 
facility  trying  to  avoid  detection,  or  they  may  try  to  overtake  a 
facility  by  force.  You  may  construct  multiple  adversary  submodels 
to  represent  different  attack  plans  and  parameterize  them  for 
User2 . 

Most  of  the  guard  and  adversary  submodels  are  built  graphi¬ 
cally  by  combining  a  series  of  nodes  and  branches  to  form  a  net¬ 
work  to  describe  the  flow  of  the  forces  through  the  facility. 
Chapter  IV  of  the  SNAP  User's  Manual  describes  the  guard  and 
adversary  submodels  in  detail.  In  addition  to  the  network  portion 
of  the  submodel,  there  are  five  submodel  statements  that  are  not 
created  graphically.  They  are  the  engagement,  combinations,  PENG, 
DENG,  and  BASE  (for  a  guard  submodel)  or  objective  (for  an  adver¬ 
sary  submodel)  statements.  Each  of  these  is  entered  in  a  menu 
driven  fashion.  The  procedure  for  entering  these  statements  is 
given  in  Section  7.1. 


7.1  Create  a  Guard  Submodel 


This  section  will  focus  on  describing  how  to  construct  a 
guard  submodel.  It  is  identical  to  the  procedure  used  to  con¬ 
struct  an  adversary  submodel ,  with  the  exception  of  a  small  number 
of  nodes  which  may  be  created  in  one  submodel  type,  but  not  the 
other . 


Once  you  have  selected  to  work  with  the  guard  submodel,  the 
'GUARD  MENU'  will  be  displayed.  Select  the  'Create  a  guard  sub¬ 
model'  option. 


WORKING  SPACE I  EXAMPLE 


GUARD  MENU 

•  CrMte'*  guars  submodel 

•  Edit  a  guard  submodel 

•  Generate  SNAP  input  statements 

•  List  guard  submodels 

•  Delete  a  guard  Submodel 

•  Quit 


|  |  -  To  Choice  t RETURN!  -  Make  Choice  ?  -  Help 


mmwmmssm.  ■ 


Figure  7.1.1:  Guard  Menu 

(Create  a  guard  submodel) 
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QUIT  <-  ESC 


C RE TURN 3  -  To  Conti nua 


Figure  7.1.1a:  Guard  Submodel  Help 


The  network  builder  page  selection  screen  will  appear  on 


your  console.  It  contains  a  grid  which  represents  the  pages 


available  for  submodel  construction  and  a  command  line.  The  pages 


are  identified  by  the  letters  and  numbers  bordering  the  grid.  You 


may  move  the  cursor  around  the  grid  by  using  the  arrow  keys  and 


select  the  page  you  wish  to  use  by  typing  [RETURN] .  For  example. 


the  cursor  is  pointing  to  page  C,2  in  Figure  7.1.2.  A  description 


of  all  the  commands  is  shown  in  Figure  7.1.2a.  Each  will  be 


discussed  later  in  this  section, 


\ 


i 


Description  of  Display  Control  Comands 

ARROWS  Hove  cursor  from  box  to  box  on  the  screen.  Each  box 
is  associated  with  a  page  on  which  the  network  way 
nay  be  drawn, 

[ENTER]  Hitting  ENTER  selects  the  page  associated  with  the  box 
that  the  cursor  is  in. 

(F)ind  Search  the  network  for  a  node  entered  frow  the  terminal. 
The  page  on  which  the  node  occurs  will  be  returned  if 
it  is  found, 

(C)heck  Check  if  all  nodes  in  the  network  have  been  filled. 

A  list  containing  the  label  and  location  of  the  nodes 
that  have  not  been  filled  will  be  shown  on  the  screen, 

(S)tate  Define  Statements  associated  with  this  submodel. 

(H)elp  Prints  this  information  to  the  screen. 

eOOit  Causes  the  program  to  terminate. 


Press  any  key  to  continue. 


Figure  7.1.2a:  Network  Builder  Page  Selection  Screen  Help 
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The  contents  of  the  page  you  selected  will  be  displayed  on 


the  screen.  The  page  id  will  appear  in  the  uppermost  right  corner 
and  a  list  of  available  options  will  be  written  along  the  bottom 
of  your  screen.  The  commands  are  described  in  the  help  file, 
which  is  listed  in  Figures  7.1.3a  and  7.1.3b.  The  basic  network 
commands  [D]elete,  [M]ove,  [E]dit,  [Plrint,  and  [O]ptions  are  the 
same  as  those  for  the  facility  submodel  and  adversary  detection 
submodel  network  builders. 


Figure  7.1.3:  Submodel  Network  Builder  Page 


Description  of  SNAP  Guard  Subnetwork  Builder  CoMnands 


ARROWS 
Crosshair 
e(N)ter 
a(L) locate 
G)oto 

R) tb 
U)ait 
I)  ask 

S) ignal 
edit 
B)ranch 


Hove  the  crosshair  in  the  appropriate  direction. 

Toggle  the  crosshair  speed  between  fast  and  slow. 

Enter  an  ENTER  node  at  the  current  crosshair  location. 
Enter  an  ALLOCATE  node  at  the  current  crosshair  location. 
Enter  a  GOTO  node  at  the  current  crosshair  location. 

Enter  a  RTB  node  at  the  current  crosshair  location. 

Enter  a  WAIT  node  at  the  current  crosshair  location. 

Enter  a  TASK  node  at  the  current  crosshair  location. 

Enter  a  SIGNAL  node  at  the  current  crosshair  location. 
Enter  an  EXIT  node  at  the  current  crosshair  location. 
Enter  the  branch  drawing  Mode. 


Press  any  key  to  continue. 


Figure  7.1.3a:  Submodel  Network  Builder  Page  Help 
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Dill  Fill  node  nenu  it  cumnt  crosshair  location, 

Annotate  Enter  text  at  the  cumnt  crosshair  location. 

Delete  Delete  current  i ten.  (Confimation  will  he  requested). 

H)ove  Move  the  node  or  text  at  the  current  crosshair  location, 

Ddit  Edit  the  node  under  the  current  crosshair  location. 

P) rint  Generate  a  hardcopy  of  the  current  facility  page  on  the  printer 

Options  Select  current  display  options. 

Q) uit  Quit  this  page  of  the  SNAP  network  builder, 

The  ESC  key  May  be  used  to  cancel  any  coxuand  in  progress, 


Press  any  key  to  continue, 


Figure  7.1.3b:  Submodel  Network  Builder  Page  Help 


PAGE  C  2 


Continue  constructing  the  network  by  adding  branches  and 


nodes.  There  is  no  contiguous  restriction  for  building  the  net¬ 
work,  so  you  can  add  a  node  or  branch  anywhere  at  anytime.  Since 
a  branch  has  direction  representing  the  flow  of  logic,  each  branch 
segment  must  begin  at  the  endpoint  of  the  branch  segment  preceding 
it  or  at  a  node.  These  branch  segments  can  be  drawn  in  any  order 
as  long  as  the  final  branch  connecting  the  nodes  is  contiguous  and 
does  not  consist  of  branches  whose  directions  differ. 

A  branch  that  does  not  have  an  end  node  will  be  coded  as  a 
RETURN  branch.  For  more  information  concerning  RETURN  branches, 
reference  the  SNAP  User's  Manual,  page  48. 

In  some  cases  you  may  want  to  specify  the  sequence  in  which 
the  branches  will  be  taken.  To  accomplish  this  you  have  the 
option  of  ranking  your  branches  when  you  are  inside  the  network 
builder.  Each  branch  may  have  a  rank  between  -99  and  100,  with  a 
default  ranking  of  0.  The  lower  the  rank  the  higher  the  priority. 

Other  restrictions  on  branches  are  that  they  can  only  con¬ 
tain  20  bend  points,  they  cannot  emanate  from  a  goto  or  exit  node, 
and  there  cannot  be  any  more  than  99  branches  leaving  a  single 
node. 


To  input  a  branch  move  the  cursor  to  the  point  where  the 
branch  is  to  begin  and  type  ( B ] .  Then  by  moving  the  cursor  the 


Description  of  Branch  Mode  Co  wands 


ARROWS  Hove  the  crosshair  in  the  appropriate  direction  and  update 
the  "rubber  band”  branch  from  the  current  origin  point  to 


the  "rubber  band"  branch  fwn  the  current  origin  point  to  the 
crosshair  location,  (The  initial  origin  point  is  the  current 
crosshair  location  at  the  tine  the  line  node  is  initiated,  but 
it  nay  be  updated  by  the  SPACE  connand.  See  below,) 


Orosshair  Toggle  the  crosshair  speed  between  fast  and  slow, 


SPACE 


Make  the  current  "rubber  band"  branch  pernanent,  and  then 
begin  entry  of  a  new  branch  with  its  origin  at  the  current 
crosshair  location. 


ENTER 


Hake  the  current  "rubber  band"  branch  pernanent,  and  then 
return  to  the  nain  connand  nenu. 


Abort  entry  of  the  current  branch  and  return  to  the  nain 
connand  nenu, 


Press  any  key  to  continue, 


Figure  7.1.5a:  Branch  Mode  Help 


You  may  enter  a  line  of  text  on  your  page  by  using  the 
(A)nnotation  command.  The  text  is  left- justified  at  the  current 
location  of  the  cursor. 
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Figure  7.1.7:  Network  Annotation 
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Description  of  fill  Mode  Commands 

AMOWS  Move  the  crosshair  in  the  appropriate  direction. 

Crosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 

ENTER  Enter  the  fill  Menu  of  the  node  which  is  positioned 
at  the  current  location  of  the  crosshair.  This  allows 
user  to  fill  in  the  data  associated  with  the  node. 

ESC  Quit  the  fill  coMMand  and  return  to  the  Main  option 
Menu. 


Press  any  key  to  continue. 


Figure  7.1.8a:  Fill  Mode  Help 
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The  new  set  of  commands  directs  you  to  move  the  cursor  to 


the  node  that  you  wish  to  fill  and  to  type  [RETURN] .  The  data 


input  menu  that  is  shown  will  depend  on  the  type  of  submodel  that 


you  are  building, 


The  data  input  menu  for  all  seven  node  types  is  shown  on  the 


next  several  pages.  Each  menu  is  followed  by  its  corresponding 


help  screen.  Note  the  difference  between  the  guard  and  adversary 


enter  node  menus. 


Figure  7.1.9:  Guard  Enter  Node  Menu 


QUIT  <-  esc 


Time  of 

Initial 

Max i mum 
to  be 


GUARD 


Definition 

arrival  (minute*) 

facility  location 

number  of  branches 
taken 


ENTER  NODE  HELP 

Opt  i  on* 

a  constant 
a  facility  1 abel 
positive  integer 


Default 


( i 

til  an) 
1 


8xx  -  where  xx  is  a  number ,  may  be  entered  in  most  fields  to  note 
par ameters 

**«*  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 
session 


CRETURNJ  -  To  Continue 


.  .  . DONE 


Figure  7.1.9a:  Guard  Enter  Node  Help 
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NETWORK  <-  tK 


ADVERSARY  ENTER  NODE  MENU 

Label  i  AE1  Comment!  ..  •  >  -  ■,  < 

Size  of  forcei.,  1  '  Type  at  weapon!  HO 

Proficiency!  HI 

Time  of  arrival  (minutes)  I  0. 0 
Initial  facility  location! 

Maximum  number  of  branches  to  be  taken!  :,|  % 

Do  you  wish  to  define  branches? .HO 

Enter  SAVE  to  save  current  values,  QUIT  to  exit  without  saving!  , 
|  |  -  To  Choice  ?  -  Help 


Figure  7.1.10:  Adversary  Enter  Node 
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:v>.v. . 


\-».V  V  V  *.-v  v.v.v, 


QUIT  <-  esc 


Definition 


ADVERBARY  ENtER  NUDE  HELP 


Options 


Force  size 


Weapon  typ« 


Prof lclency 


CRETURN! 


1  nteijpr 

I  IB  ham li |ni  i 
till  sllptqilll 
fif\  cnmi -  automat i c 
BM-gubmachl  nn  ijtin 
FA  fully  automatic 
NW-no  weapon 

-IOO  to  lOU 


To  Continue 


.  .  . MURE  I 


QUIT  EBC 


Time  of  arrival  (minutes) 

Initial  facility  location 

Maximum  number  of  branches 
to  be  taken 


a  constant 


a  facility  1 abel 
puntive  integer 


Ixk  -  wfiere  xx  is  a  number,  may  bn  entered  in  most  fields  to  note 
parameters 

»«»*  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  tn  this  menu  screen  during  thin 
session 


C RETURN!  -  To  Conti nu* 


Figure  7.1.10a:  Adversary  Enter  Node  Help 
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\  » 


ALLOCATE  NODE  MENU 


Label i  AL1  Comment  i  -4  < 

Base  1  abel 

Number  of  guards  being  allocated!  9 
Maximum  number  of  branches  to  be  taken i  '  1 
Do  you  wish  to  define  branches?  NO 

Enter  SAVE  to  save  current  values,  Ullir  to  exit  without  saving: 


|  {  -  To  Choice  ?  -  Help 


Figure  7.1.11:  Allocate  Node  Menu 


Wit  <-  t*e 


ALLOCATE  NODE  HELP 


Definition 


Options 


Def aul t 


Base  label 


label  of  a  BASE 


«  • 


Number  of  guards  being 
al located 


integer  >=  0  or  global 
variable 


Maximum  number  of  branches 
to  be  taken 


positive  integer 


1 


•xx  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 

par ameters 

••••  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


t RETURN!  -  To  Continue 


.  .  . DONE 


Figure  7.1.12:  RTB  Node  Menu 


QUIT  <-  K*C 


RTB  NODE  HELP 


Definition 


Base  label 

Maximum  number  of  branches 
to  be  taken 


Op  1 1  one 


label  of  a  BASE 


positive  integer 


•xx  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 

parameters 

••••  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  tins 

session 


(RETURN!  -  To  Continue 


.  .  .DONE 


Figure  7.1.12a:  RTB  Node  Help 


# 


NSTWONK  *-  ESC 


##:• 


6ISNAL  NODE  MENU 

Label!  SION 

Signal  specif  lcatiom  WM 
Maximum  numb ar  of  branches  to  ba  taken l  MU 
Do  you  wish  to  define  branches? iNBi 

Enter  SAVE  to  save  current  values,  QUIT  to  exit  without  saving!  Mi 


|  |  -  To  Choice 


?  -  Help 


Figure  7.1.13:  Signal  Node  Menu 


QUIT  <-  CSC 


SIGNAL  NODE  HELP 


Definition 

Options 

Default 

Signal  specification 

See  next  page 

«« 

Maximum  number  of  branches 
to  be  taken 

positive  integer 

1 

•xx  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 
parameters 

-  denotes  fields  which  cannot  be  defaulted 
ESC  -will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


t RETURN!  -  To  Continue 


.  .  . MORE 


QUIT  <-  ESC 


The 

SIGNAL  specification  takes  one  of  two 

general  forms. 

RSI 

RS2 

RS3 

LOGIC  POINT  or 

TEMPORARY 

nsv 

TRAN 

WAIT  node  label 

PERMANENT 

blank 

ADVERSARY 

Facility  Location 

or  TISV 

TRAN 

GUARD 

Force  Identifier 

Network 

node  1 

1  abel 

where  1 

force 

goes 

t RETURN 3 

-  To  Continue 

a  a  a  DONE  | 

Figure  7.1.13a:  Signal  Node  Help 
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NCTMORk  <-  ESC 


EXIT  NODE  MENU 

Label  i  EX1  :w,  ,  :  f 

Stop  optloni?!^  " 

Enter  SAVE  to  save  current  values,  QUIT  to  exit  without  saving: 


j  |  -  To  Choic 


?  -  Help 


Figure  7.1.14:  Exit  Node  Menu 


Definition 


Stop  option 


EXIT  NODE  HELP 


Options 


blank  or  STOP 


bum  mmm 


-  where  kh  is  a  number,  may  be  entered  in  most  fields  to  note 
parameters 

-  denotes  fields  which  cannot  be  defaulted 

-  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


C RETURN]  -  To  Continue 


.  .  .  DONE 


Figure  7.1.14a:  Exit  Node  Help 
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TA8K  NODE  MENU 

Label  i  T12  Comment i  mmmmm  m  * 

Facility  locationi  5  Model  SBKHU&SfflM 

Task  timeiCQNlOl  Auxiliary  actloni 

Wirt  engagement  label t  ? V ’  Start  engagement  label i 

Maximum  number  of  branches  to  be  takeni  lllw 

Define  engagement  pointersi  NO 

Do  you  wish  to  define  branches? -M) 

Enter  SAVE  to  save  current  values,  QUIT  to  exit  without  saving! 


|  j  -  To  Choice 


Figure  7.1.15s  Task  Node  Menu 


-  Help 


Figure  7.1.15a:  Task  Node  Help 
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QUIT  <-  ESC 


Auxiliary  action 


ACTIVAlCtl  Pt  > 
DISABLE (LBL) 

SET (OLBL .value) 
CM  l  (MLRL) 

MAPI  (TIMR) 
RECORD <T IMR) 


1)1  an) 

(no  an:.  1  1  i  »r  y 
art  1  on ) 


Ml n  engagement  label 


blank , 
CONTINUE 
ST  DA, 

node  label 


bl  an) 


Start  engagement  label 


blank,  or  node  label 


b  I  aril 


t RETURN!  -  To  Continue 


.MORE 


QUIT  O  ESC 


Maximum  number  of  branches 
to  be  taken 


positive  integer 


■xx 


•  ••• 

ESC 


-  where  xx  Is  a  number,  may  be  entered  In  most  fields  to  note 

parameters 

-  denotes  fields  which  cannot  be  defaulted 

-  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


[RETURN]  -  To  Continue 


.  .  . DONE 


Figure  7.1.15a:  Task  Node  Help  (continued) 
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«  *''  m  A 


a  -  *  ml 


*  I.*  1/ 


••I 

VJ 

vr 


WETWOAK  <-  CSC 


WAIT  NODE  MENU 


Label i  W1  Comment i 

Auxiliary  actlonl 


Win  engagement  label  i^W^f 


*1  'iff',  £*  *m  m ' » ! t  - 


Start  engagement  label i 


Max  1  mum  number  of  branches  to  be  t  alien  i 
Define  triggers  to  release  the  forcei  WO 
Define  engagement  pointers!  NQ 
Do  you  wish  to  define  branches?&NQ 

Enter  SAVE  to  save  current  values,  QUIT  to  exit  without  saving: 


t  t  -  To  Choi< 


-  Hel  p 


Figure  7.1.16:  Wait  Mode  Menu 


V  V*  V  V  V  V  *S.-  V  s.r'  r.  "T.  •  v' 


{  /.  *  ,1  .  /  .  *  a"  *  /"  0L  •  »  '  *  t  », 


QUIT  <-  ESC 


WAIT  NODE  HELP 


Definition 


Options 


Auxiliary  action 


MERGE , TRANSFER ,  or  blank 


Win  engagement  label 


blank 

CONTINUE 

STOP 

Node  label 


Start  engagement  label 


blank  or  node  label 


Maximum  number  of  branches 
to  be  taken 


positive  integer 


C RETURN 1  -  To  Continus 


.  .  . MORE 


OUST  <-  ESC 


Define  triggers  to  release 
the  force 


See  HELP  under  trigger 
menu 


Define  engagement  pointers 


See  HELP  under  engagement 
pointer  menu 


*xx  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 
parameters 

*«**  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 
session 


C RETURN 1  -  To  Continue 


.  .  . DONE 


Figure  7.1.16a:  Wait  Node  Help 


SS5 


.WWW 


RELEASE  TRIGGER  MENU 


Tr igger i 

f 


Exit  r trigger  menu ■  %  NO 


The  wait  node  triggers  define  the  conditions  that  must  exist 
to  release  the  forces  at  the  wait  node.  To  describe  the  triggers, 
answer  1  yes1  to  the  define  trigger  question.  You  must  follow  the 
format  for  triggers  exactly  as  shown  in  the  trigger  help  informa¬ 
tion  or  a  SNAP  input  error  will  be  detected  at  the  time  of  execu¬ 
tion.  You  must  supply  a  trigger  for  every  wait  node. 


Figure  7.1.17:  Release  Trigger  Menu 


i 


QUIT  <-  ESC 


TRIGGER 


WAIT  I  OR 


GUARD, facility  label 
ADVERSARY, facility  label 
ADD, ADD  label 
SIGNAL 

TINC,  value  or  global 
variable 

ENGAGEMENT .facility  label 


guard  at  facility  location 
adversary  at  facility  location 
ADD  to  be  triggered 
signal  from  another  force 
a  per  iod  of  tune  in  mum  tee 

engagement  at  facility  location 


[RETURN]  -  To  Continue 


.  .  . MORE 


QUIT  <-  ESC 


Triggers  may  be  combined  with  an  .AND.  operator  to  form  combined 
triggers  (e.g.,  GUARD, SP1 . AND. ADD, Ml > .  Multiple  triggers  (OR  conditions) 
may  be  specified  by  separating  (possibly  combined)  triggers  with  .OR. 
operators  (e.g.,  GUARD ,SP. AND. ADD, Ml .OR. T INC, 2) . 

Any  trigger,  eKcept  TINC,  can  be  preceded  by  a  "NOT."  operator. 

The  "NOT."  applies  only  to  the  trigger  immediately  following. 

EXAMPLES 

( GUARD , SP 1 . OR . NOT . ENGA , 5P6 ) 

(NOT. ADD, SI) 

(NOT . QUA , SP2 . AND. NOT . ENGA, SP2 . OR. TINC, 5) 


[RETURN]  -  To  Continue  .  .  .MORE 


Figure  7.1.17a: 


Trigger  Help 
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•mm  -  w here  mm  is  a  number ,  nay  ba  entered  In  most  fields  to  note 

parameters 

****  -  denotes  fields  Mhich  cannot  br  defaulted 

ESC  -  Mill  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


C RETURN 1  -  To  Continue 


.  .  . DONE 


Figure  7.1.17a 


Trigger  Help  (continued) 


//* 


At  the  time  you  supply  data  for  a  node  you  will  have  the 
option  to  define  the  branches  that  emanate  from  it.  By  answering 
'yes'  to  the  define  branches  question,  a  list  of  all  branches 
leaving  that  node  will  be  displayed  on  the  screen.  You  may  cursor 
to  the  branch  you  wish  to  define  and  select  it  by  typing  [RETURN]. 


BRANCHES  FROM  NODE 


TO 

TYPE  NODE 
DEC  T<? 
DEC  T4 
DEC  T7 


NODE  MENU  <-  BSC 


FOR- 
K  AMI  1  1 1  IN 

3  0.0 

1  r‘i  .  «.» 

2  0 .  0 


Quit  Branch  Editing  Session  and  Save1 


I  \  -  To  Choice  CRETURNJ  -  Make  Choice 


Figure  7.1.18:  Branch  Selection  List  Menu 


- 

QUIT  <-  esc 

Arrow. 

BRANCH  SELECTION  HELP 

-  mow  up  or  down  the  list  one  item  at  a  time. 

PgUp  - 

move  up  the  list  a 

page  at  a  time. 

PgDn  - 

move  down  the  list 

a  page  at  a  time. 

Home  - 

move  to  the  top  of 

the  list. 

End 

move  to  the  bottom 

of  the  list. 

RETURN 

-  FI  11 /Edit  branch 

currently  selected. 

C RETURN 3 

-  To  Continue 

.  .  . DONE 

The  branch  input  menu  for  a  regular  branch  will  be  displayed 
for  all  new  branches.  If  there  is  only  one  branch  leaving  the 
node,  you  will  enter  this  menu  directly,  skipping  the  branch 
listing  menu.  If  you  change  the  branch  type  to  decision,  DEC,  or 
probability,  PRO,  additional  data  is  required.  The  decision  and 
probability  branch  menus  are  displayed  in  Figures  7.1.20  and 
7.1.21. 


f  |  -  To  Choice 


Figure  7.1.20:  Probability  Branch  Menu 


BRANCH  LISTING  ESC 


Define  branch  from  node  T5  to  node  T 6 


Comment : 


Portion  of  force  to  take  this  branch!  0,0 


Branch  type,  (REG,  DEC,  PRO):  DEC 


Condition  for  branch! 

{PI. IS. ACT) 


Branch  ranking!  2 


Exit  branch  menu!  NO 


J  |  -  To  Choice 


-  Hei  p 


Figure  7.1.21:  Decision  Branch  Menu 


t  r  Vl 


•5 


DECISION  Branching 


Condition  to  teat. 

I f  it  la  trua,  tha  branch 
la  takan 


Saa  Uaer ' a  Qui da 


PROBABILISTIC  Branching 


Probability  of  aalactlng  thia  constant  or  global 
branch  variable  between 

0  and  1 


•mm  -  whara  mm  ia  a  numbar ,  nay  ba  entarad  in  aoat  fialda  to  note 

paramatera 

••  -  danotaa  fialda  which  cannot  ba  defaulted 

ESC  -  will  cancel  any  changae  aada  to  thia  menu  acraan  during  this 

eeeaion 


t RETURN!  -  To  Continue 


.  .  .DONE 


Figure  7.1.21a:  Branch  Help 


To  enter  the  wait  and  task  node  engagement  pointers  you  must 
answer  'YES'  to  the  define  engagement  pointers  question.  The  list 


of  engagement  pointers  will  appear  initially  blank.  To  add  an 


engagement  pointer  to  the  list  type  [A]. 


ENGAGEMENT  POINTERS  FOR  NODE  T12 


NODE  MENU  <~  ESC 


FACILITY 
LOCATION 
SAVE  :  ■  :> 


ENGAGEMENT 

LAPEL 


f  \  -  To  Choice  A  -  ADD  D  -  DEL  <RET>  -  EDIT 


?  -  Help 


Figure  7.1.22:  Engagement  Pointer  Selection  List  Menu 


Figure  7.1.22a:  Engagement  Pointer  Selection  Help 


An  input  menu  will  be  displayed  allowing  you  to  enter  the 


data  associated  with  the  new  engagement  pointer.  The  range  must 


be  specified  as  an  integer.  To  save  and  exit  the  menu  you  must 
type  [RETURN]  in  the  last  data  field. 


ENGAGEMENT  POINTERS  FOR  NODE  T12 


<.X«nN9;:|SMl;^  CSC 


ENGAGEMENT  POINTER  MENU 


Facility  location! 


Rang*  (meters)! 


Lab*l  for  engagement  processing! \ 


f To  Choic* 


Figure  7.1.23:  Engagement  Pointer  Menu 


suit  <-  esc 


ENGAGEMENT  POINTER  HELP 


Definition 


Options 


Facility  location 


f aci I i ty  1 abel 


Rang* 


distance  in  meters 


Label  for  engagement  processing  PENG  label 


as  spec  1 f i ed  on 
ENGAGEMENT  card 


RETURN  -  in  last  field  to  return  to  NODE  MENU  with  updated  information 
lux  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 
parameters 

•***  -  denotes  fields  which  cannot  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 

sessi on 


t RETURN!  -  To  Continue 


.  . DONE 


Figure  7.1.23a:  Engagement  Pointer  Help 


1, 


m 


Once  you  leave  the  data  input  menu,  the  engagement  pointer 
list  will  be  displayed  containing  the  updated  information.  You 
may  continue  to  add  new  engagement  pointers  or  edit  or  delete  old 
pointers.  To  save  the  changes  you  made  during  the  session  select 
the  'SAVE'  option. 


ENGAGEMENT  POINTERS  POR  NODE  T12 


NODE  MENU  <-  ESC 


FACILITY 

LOCATION 

03 


RANGE 

10 


ENGAGEMENT 

LAPEL 

PGl 


f  I  -  To  Cholc*  A  -  ADD  D  -  DEL  <RET>  -  EDIT 


?  -  H*lp 


Figure  7.1.24s  Engagement  Pointer  Selection  List  Menu 
After  Input 


1  *  •  «  *  A 


-  v  V  v  •.  \  /.  ' 

‘  •  '-r  V  ••  /’AvV  V  V.v 
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There  are  several  support  commands  available  to  aid  you  in 
the  construction  of  your  submodel.  These  commands  are  [Dlelete, 
[M]ove,  [E]dit,  tPlrint,  and  [Olptions. 

The  delete  command  allows  you  to  remove  a  node,  branch  or 
annotation  from  a  page.  To  delete  an  item  place  the  cursor  in  the 
middle  of  the  node  or  branch,  or  at  the  beginning  of  a  text  string 
and  type  [D].  The  item  selected  for  deletion  will  begin  to  flash 
and  you  will  be  asked  to  verify  the  selection.  Answer  yes  to  the 
query  and  the  item  will  be  deleted. 

The  edit  command  allows  you  to  change  the  node  label  of  a 
node.  You  can  change  the  label  by  placing  the  cursor  in  the 
middle  of  the  node  you  wish  to  edit  and  type  [E] .  Then  enter  the 
new  label  in  the  field  which  appears.  The  node  will  be  redrawn 
with  the  new  label. 

The  print  command  is  used  to  print  a  hard  copy  of  the 
current  page.  By  typing  IP]  and  verifying  that  you  want  a  copy, 
the  page  is  printed. 


The  move  command  is  used  to  move  a  node  from  one  position  to 
another.  Place  the  cursor  in  the  middle  of  the  node  you  wish  to 
move  and  type  [M],  You  can  then  move  the  node  around  the  page 
using  the  arrow  keys.  Type  {RETURN!  to  fix  the  node  at  its  new 
location . 


14  PAGE  C  2 


Hove  Node  Cowwnds:  ARROWS,  C,  ENTER,  ESC,  ?(help) 


Figure  7.1.25:  Move  Mode 


S-K’&'sw 


Description  of  Hove  Mode  CoMMands 


ANTONS  Hove  the  crosshair  and  associated  node  or  text  in  the 
appropriate  direction. 


Orosshair  Toggle  the  crosshair  speed  between  fast  and  slow. 
ENTER 


Complete  the  wove  command  by  fixing  the  location  of  the 
node  or  text  associated  with  the  crosshair  at  its  current 
location.  End  wove  mode  and  return  to  the  wain  command 
Menu. 


ESC 


Abort  the  current  Move  coMMand  and  return  the  node  or  text 
associated  with  the  crosshair  to  its  position  prior  to  the 
start  of  the  Move  coMMand.  End  Move  Mode  and  return  to  the 
Main  coMMand  Menu. 


Press  any  key  to  continue. 


Figure  7.1.25a:  Move  Mode  Help 
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Description  of  Display  Option  Comanfc 


ii 


G)rid  Toggle  the  grid  display  on  or  off. 

Annotation  Toggle  the  display  of  annotation  on  or  off. 

Uabel  Toggle  the  display  of  SNAP  node  labels  on  or  off. 

Sltatus  Display  a  report  on  the  status  of  the  display  options, 
status  of  the  current  display  page  and  status  of  the 
overall  facility. 

All  display  option  comands  return  to  the  Main  conwand  Menu  upon  conpletion. 


Press  any  key  to  continue. 

Figure  7.1.26a:  Display  Options  Mode  Help 


I  ^  *  *>•*>**  V  A  ,**  A  A  *»  * .  %  N  A  *4  A 


You  may  also  display  the  status  of  your  submodel.  This 
option  gives  you  a  summary  of  the  network  status,  page  status,  and 
display  status.  The  network  status  consists  of  the  number  of 
branches,  nodes,  and  annotations  currently  in  the  submodel  and  the 
number  of  bytes  free  in  memory.  Since  memory  is  dynamically 
allocated,  the  size  of  your  submodel  is  limited  only  by  the  amount 
of  memory  you  have  on  your  microcomputer.  As  shown  in  Figure 
7.1.27,  the  number  of  bytes  free  will  always  read  65000  until  you 
have  less  than  that  amount  available. 

Network:  C:\SNAP\USER1\SCRAICH 


Network  Status 

40  Branches 
25  Nodes 
2  Annotations 
65000  Bytes  Free 


Page  Status  Display  Status 


Page  No,  D,  3  Grid:  ON 

28  Branches  Annotation:  ON 

18  Nodes  Nodes:  ON 

0  Annotations  Node  Labels:  ON 


Press  any  key  to  continue, 


Figure  7.1.27:  Network  Status  Diagram 


■  vV') 

A 

To  verify  that  you  have  supplied  the  data  for  each  node,  you 
can  perform  a  check  on  the  network  by  typing  [Cl.  A  message  will 
be  displayed  at  the  bottom  of  the  screen  each  time  an  empty  or 
unfilled  node  is  found.  You  must  hit  any  key  to  continue  the 
search.  When  it  has  completed,  the  message  'Finished  search.  Hit 
any  key  to  continue'  will  be  displayed.  You  must  fill  every  node 
before  you  can  generate  a  valid  SNAP  input  statement  file. 


Node  16,  on  page  C,  2  has  not  Been  filled,  Hit  a  key  to  continue, 

Figure  7.1.29:  Check  Option 
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To  find  the  page  on  which  a  node  is  located,  you  may  use  the 
(F)ind  command.  By  typing  [F]  and  entering  the  node  label  in  the 
field  that  is  displayed,  the  program  will  return  the  page 
identifier  in  which  the  node  is  found.  If  a  node  is  associated 
with  goto  nodes,  the  program  returns  the  page  identifier  for  all 
goto  nodes  and  the  node  itself. 


12  3  4  5  ( 


Nod'  l»ltl?  | 


Figure  7.1.30:  Find  Option 


iW 


To  complete  the  submodel  you  must  supply  the  engagement, 
combination,  PENG,  DENG,  BASE  and  objective  statements.  To  enter 
the  statement  definition  mode  you  must  type  [S]  while  on  the  page 
selection  screen.  The  'STATEMENT  DEFINITION  MENU'  will  be  dis¬ 
played.  The  guard  and  adversary  statement  definition  menus  are 
shown  in  Figures  7.1.31  and  7.1.32.  The  two  submodel  menus  differ 
only  in  the  third  statement  type.  For  a  guard  submodel  you  must 
define  BASE  statements  and  for  an  adversary  submodel  you  must 
define  an  objective  statement. 

i  page  select  <-  esc 

i  i 

I  STATEMENT  DEFINITION  MENU  I 

I  I 

I  I 

I  I 

I  ->  Def in#  engagement  statement  I 

I  ->  Define  combinations  statement  I 

I  ->  Define  BASE  statements  | 

I  ->  Define  PENG  statements  l 

I  ->  Define  DENG  statements  I 

I  ->  Quit  statement  definition  menu  I 


}  J  -  To  Choice  ”  -  Help 


Figure  7.1.31:  Guard  Statement  Definition  Menu 


STATEMENT  DEFINITION  MENU 


PAM  Muter  <-  ESC  "l 


.*•>  DPfine  Statement 

->  Define  combinations  statement 
->  Define  objective  statement 
->  Detin*  PENG  statements 
->  Detine  DENG  statements 
->  Quit  statement  definition  menu 


I  t  J  -  To  Choice 

■  . 


•>  -  Help  I 

...  — _ I 


Figure  7.1.32:  Adversary  Statement  Definition  Menu 


QUIT  <-  CQC 


STATEMENT  DEFINITION  HELP 


There  are  five  statement  types  associated  with  the  submodel. 
Submodels  will  not  necessarily  remtain  aJ 1  of  the  statements, 
you  need  only  to  create  the  statements  associated  with  your 
own  model.  Move  the  highlighted  blocl  to  the  statement 
category  you  desire  to  create/edit  and  hit  [RET URN 3 . 


t RE TURN 1  -  To  Continue 


.  DONE 


Figure  7.1.32a:  Statement  Definition  Help 
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The  procedure  for  supplying  the  BASE,  PENG  and  DENG  state 
ments  are  identical.  The  PENG  statement  will  be  used  as  an  ex¬ 
ample.  Select  the  PENG  statement  option  to  list  all  of  the  de- 


A  menu  containing  default  values  will  be  displayed  allowing 
you  to  enter  the  data  associated  with  the  PENG  statement.  To  save 
the  statement,  type  [RETURN]  in  the  last  data  field.  The  list  of 
PENG  statements  will  now  show  the  updated  status.  To  add  another 
PENG  statement,  you  need  only  type  [A].  It  is  imperative  to  SNAP 
that  the  PENG  statements  be  in  a  particular  order.  When  adding 
statements  to  a  list  remember  that  the  new  statement  is  inserted 
into  the  list  prior  to  the  line  highlighted  by  the  cursor.  From 
the  listing  menu  you  may  also  delete  a  PENG  statement  (type  CD]) 
or  edit  (type  [RET])  an  existing  statement. 


UtartNO  MENU  «»  CSC 


PENS  STATEMENT  MENU 


PENS  label  i  W: 


Correspond! ng  DENG  label  iW 
Time  Interval  till  next  changei 


|  }  -  To  Choice 


Figure  7.1.34:  PENG  Statement  Menu 


?  -  Help 


Definition 


PENG  STATEMENT  HELP 

Options 


QUIT  <-  BBC 


Dr*  f  aul  t 


PENG  label 
DENG  label 


4  character*  max 

label  of  DENG  in  same 
(GURAD  or  ADVESARY)  section 

numeric  (minutes) 


Time  interval  till  next  numeric  (minutes) 

change  of  characteristic 

gxx  _  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 
parameters 

-  denotes  fields  which  cannot  be  defaulted 
ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 


C RETURN!  -  To  Continue 


Figure  7.1.34a:  PENG  Statement  Help 


sot; 


V .  *  *  > v% > S  v 
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The  data  input  menus  for  the  DENG  and  BASE  statements  are 


given  on  the  next  several  pages.  The  procedure  for  supplying  them 
is  identical  to  that  for  the  PENG  statement. 


LISTINB  HKMU  <-  CSC 


DENG  STATEMENT  MENU 

DENG  label  *.<*.«:•>  •  Posture i  STANDING 

Exposure  while  firing*  400  Exposure  while  loadings  ICO 

Percent  time  delays  0 

Self  posture  firing  degradations  0 

Illumination  firing  degt adation*  0 

Suppression  status*  NO 

Tactics  ASSAULT 


f  \  -  To  Choice 


?  -  Help 


Figure  7.1.35:  deng  Statement  Menu 


I 

) 

* 


suit  <*  esc 


DENG  STATEMENT  HELP 


Def  ini  tion 

Options 

Def aul t 

DENG  label 

4  characters  max 

*« 

Posture 

CROUCHING,  STANDING, 

OR  PRONE 

STANDING 

Exposure  while  firing 

numeric  (0-100) 

100 

Exposure  while  loading 

numeric  (0-100) 

100 

Percent  time  delayinq 

numeric  (0-100) 

0 

(RETURN!  -  To  Continue 

-  —  -  - 

.  .  .  MORE 

ouit  <-  esc  ] 


Self  pasture  firing 
degradation 

Illumination  firing 
degradation 

Suppression  status 

Tactic 


numeric  (0-100)  0 

numeric  (0-100)  0 

YES , NO  NO 

ASSAULT , DEFENSE  ASSAUL  T 


•km  -  where  km  Is  a  number,  may  be  entered  in  most  fields  to  note 

par ameters 

**  -  denotes  fields  which  cannot  be  defaulted 

ESC  -will  cancel  any  changes  made  to  this  menu  screen  during  th> s 

session 


(RETURN!  -  To  Continue 


-DONE 


Figure  7.1.35a:  DENG  Statement  Help 
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Figure  7.1.36:  BASE  Statement  Menu 


BALE  ELEMENT  HELP 


Daf i nit ion 


BASE  Imtiml 

Initial  numbar  of  guards  in 
tha  BASE 

Waapon  type 


Proficiency 


CRETURN]  -  To  Continua 


Options 

4  characters  max 


i nteger 


HG— handgun 
SG— shotgun 
SA-sem' -automatic 
GM  -submachine  gun 
FA— ful i /  automatic 
NW-no  weapon 

-loo  to  100 


Default 


.  . MORE 


Figure  7.1.36a:  BASE  Statement  Help 
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Unlike  the  PENG/  DENG/  and  BASE  statements  which  may  have 


multiple  statements  per  submodel/  only  one  of  the  engagement, 
combination,  and  objective  statement  can  exist  in  a  submodel.  The 
combination  statement  is  not  required  for  all  submodels.  To 
supply  these  statements,  select  the  statement  type  from  the 
'STATEMENT  DEFINITION  MENU'.  A  data  input  menu  containing  the 
defaults  will  be  displayed.  By  typing  [RETURN]  in  the  last  data 
field  you  exit  the  menu  and  return  to  the  'STATEMENT  DEFINITION 
MENU' . 


_ _ _  STATE.  06F.  <-  ESC 

ENGAGEMENT  STATEMENT  MENU 

Fo|rce  slie  at  which  the  lore*  loses  the  engagement!  O 
PENG  label  ■for  default  engagement*  *5 


♦  ♦-To  Choice  7  ..  Help 


5 

1 


§ 


Figure  7.1.37:  Engagement  Statement  Menu 


SUIT  <-  CSC 


ENGAGEMENT  STATEMENT  HELP 


Definition  Options  Default 


Force  size  at  which  the  force  number  or  global  O 

loses  the  engagement  variable 

PENG  label  for  default  a  defined  PENG  label  •• 

engagement 

•xx  -  where  xx  is  a  number,  may  be  entered  In  most  fields  to  note 
parameters 

****  -  denotes  fields  which  cannot,  be  defaulted 

ESC  -  will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


[RETURN]  -  To  Continue  ,  ,  .DONE 


Figure  7.1.37as 


Engagement  Statement  Help 
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•TATE.  DEF.  <-  R*C 


■TAT*.  DCT.  <-  CSC 


OBJECTIVE  STATEMENT  MENU 
Adversary  mission  objsctivsi  WOTftdC 
Facility  locationsi 


f  |  -  To  Choi  cm  ?  -  Help 


Figure  7.1.39:  Objective  Statement  Menu 


ouit  <-  ESC 


OBJECTIVE  STATEMENT  HELP 


Definition  Options  Default 


Mission  objective  SABOTAGE  or  THEFT  SABOTAGE 

List  of  facility  locations  defined  facility  •* 

that  must  be  reached  to  location 

satisfy  objectives 

•xx  -  where  xx  is  a  number,  may  be  entered  in  most  fields  to  note 

parameters 

****  -  denotes  fields  which  cannot  be  defaulted 

ESC  -will  cancel  any  changes  made  to  this  menu  screen  during  this 

session 


CRETURN3  -  To  Continue 


.  .  . DONE 


Figure  7.1.39a: 


Objective  Statement  Help 


Once  you  have  supplied  all  the  statement  information  you  may 
exit  the  statement  definition  mode  by  quitting  from  the  'STATEMENT 


DEFINITION  MENU'. 

If  you  have  completed  working  with  the  submodel,  you  may 
leave  from  the  graphical  network  builder  by  typing  [ X 3 .  You  will 
then  be  asked  to  supply  a  name  under  which  the  guard  submodel  will 
be  saved.  If  you  type  [ESC]  or  enter  quit  in  the  name  field,  you 
will  exit  without  saving  any  of  the  changes  you  have  made.  If  you 
were  editing  an  existing  submodel,  the  name  of  that  submodel  would 
appear  in  the  data  field  and,  by  typing  [RETURN],  you  would  save 
the  updates  to  the  submodel.  If  you  supply  a  new  submodel  name, 
the  updates  will  be  stored  under  the  new  name  and  the  old  submodel 
will  remain  unchanged.  If  the  new  name  is  the  same  as  an  existing 
submodel,  you  may  choose  to  re-enter  the  name  or  overwrite  the  old 
submodel . 

I  WORKING  SPACE,  EXAMPLE  MAIN  <-  ESC  I 

| - - - — - - 

I  GUARD  SUBMODEL  FILE  NAME  MENU  I 

I  I 

I  Enter  *  new  n«mt  for  this  file! 

I  hit  return  for  the  default,  i 

I  or  type  QUIT  to  lesve  this  menu  without  saving  the  new  data. 


CRETURN3  -  To  Continue 


Figure  7.1.40:  Guard  Submodel  File  Name  Menu 
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After  you  have  entered  the  name  for  the  submodel,  you  will 
be  asked  to  supply  a  description  to  be  associated  with  the  sub¬ 
model.  A  specific  description  will  help  identify  what  is  con¬ 
tained  in  the  submodel . 


WORKING  SPACE I  EXAMPLE 


MAIN  <~  ESC 


GUARD  SUHMUDLL  MIL  NAMI  Ml  NU 

Entor  a  lino  o<  danrr  1  pt  1  on  I  nr  f  t  Ipi  II 

Or  hit  rat urn  to  koop. 

guard  patrol  procodur**  with  on*  patrolling  fore* 


(RETURN!  •  To  Contlnnn 


Figure  7.1.41s  Guard  Submodel  File  Name  Description  Menu 


- .. 

V  AD-A181  139  CREATING  SECURITV  SVSTEN  MODELS 
1  NATIONAL  LABS  ALBUOUERSUE  NA  C 
i  SAND8W185  DE-AC84-7S0P00789 

1  UNCLASSIFIED 

USING  SNAP- 
D  TOBIN  ET 

PC<U>  SAND I A  3/4  ' 

AL.  AAV  87 

F/G  12/3  NL 

M2 

n 

■  - 

MICROCOPY  RESOLUTION  TEST  CHART 

NATIONAL  BUREAU  Of  STANDARDS  1963  A 


7.2  Edit  a  Guard  Submodel 


To  edit  an  existing  submodel  choose  the  edit  option  on  the 
1  GUARD  MENU  1 . 


WORKING  SPACE i  EXAMPLE  SUBMODEL  C-ESC 


GUARD  MENU 

•  Create  a  guard  submodel 

•  Edit  a  guard  submodel 

•  Generate  SNAP  input  statements 

•  List  guard  submodels 

•  Delete  a  guard  submodel 

•  Quit 


t  }  -  To  Choice  t RE TURN J  -  Mate  Choice  ?  -  Help 


Figure  7.2.1s  Guard  Menu 

(Edit  a  guard  submodel) 
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vSv 


175 


Than  aalact  from  tha  list  tha  submodel  you  wish  to  edit. 


WORKING  SPACE l  EXAMPLE 


main 


NAME 


DAY  TWO 
NGHT  ONE 
NBHTTWO 
QUIT 


GUARD  SUBMODEL  SE  LECT  I UN  MENU 
DEHOR  tr  HUN 


,„|t»;tl(fi|f«licG::B»tpoI.:,ipro<i««tur,**f>wlfch;on*'ipAtrisn:lns  fare* 
laytime guard  patrol  procedures  with  two  patrolling  lorcos 
nighttime  guard  patrolling  procedures  w/  one  patrol  force 
nighttime  guard  patrol  procedures  w/  two  patrolling  forces 
Quit  this  menu 


|  f  -  To  Choice 


[RETURN!  -  Make  Choice  ?  -  Help 


Figure  7.2.2:  Guard  Submodel  Selection  Menu 


OUt?i«*:::«8e 


GUARD  EUUMUDEL  SELECTION  HELP 


Use  the  arrow  keys  to  aelect  the  guard  submodel  with  which  you 
want  to  work. 


CRETURN1  -  To  Continue  .  .  .DONE 


Figure  7.2.2a:  Guard  Submodel  Selection  Help 


7.3  Generate  SNAP  Input  Statements 

You  may  generate  the  SNAP  input  statements  by  selecting  the 
'Generate  SNAP  input  statements'  option  from  the  'GUARD  MENU*. 


i - 

I  WORKINB  SPACE I  EXAMPLE 


SUBMODEL  <-£SC 


GUARD  MENU 


•  Create  a  guard  submodel 

•  Edit  a  guard  submodel 

*:  t  * :  SNAP  I  rtput  *t »t  ««*»n  t  • 

•  List  guard  submodels 

•  Delete  a  guard  submodel 

•  Quit 


|  |  -  To  Choice  tRETURNJ  -  Mate  Choice  ?  -  Help 


Figure  7.3.1j  Guard  Menu 

(Generate  SNAP  input  statements) 
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A  submodel  selection  menu  will  appear  which  allows  you  to 
select  the  submodel  for  which  you  wish  to  generate  statements. 

The  file  that  is  generated  ('name'. GSM)  is  located  in  your  working 
space  subdirectory. 


WORKING  SPACE I  EXAMPLE  MAIN  <-  ESC 


GUARD  SUBMODEL  St LCCT ION  MENU 
NAME  DESCRIPTION 


OAY.ON*  -  Daytlm*  guard  patrol  preeadurps  With  on*  patrolling  tor  cm 

DAY_TWO  Daytime  guard  patrol  procedures  with  two  patrolling  forces 

NGHT_ONE  nighttime  guard  patrolling  procedures  w/  nnt  patrol  force 

NGHT_TWO  nighttime  guard  patrol  procedures  w/  two  patrolling  forces 

QUIT  Quit  this  menu 


Figure  7.3.2:  Guard  Submodel  Selection  Menu 
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7.4  List  Guard  Submodels 


To  get  a  listing  of  all  the  guard  submodels  that  currently 
exist,  select  the  'list'  option. 


WORKING  SPACE l  EXAMPLE 


SUBMODEL  < -ESC 


GUARD  MENU 


•  Create  a  quart)  submodel 

•  Edit  a  guard  submodel 

•  Generate  SNAP  input  statements 

•  List  fluwd  submodel  a 

•  Delete  a  guard  submodel 

•  Quit 


\  \  -  To  Choice 


C RETURN 1  -  Mate  Choice 


-  Hel  p 


Figure  7.4.1:  Guard  Menu 

(List  guard  submodels) 


WORKING  SPACE I  EXAMPLE 


MAIN  <.-i  ESC 


GUARD  SUBMODEL  DESCRIPTIONS 
DESCRIPTION 


DAY_ONE  Daytime  guard  patrol  procedures  with  one  patrolling  forte 

DAT-TWO  Daytime  guard  patrol  procedures  with  two  patrolling  -ferret. 

NGHT_ONE  nighttime  guard  patrolling  procedures  w/  one  patrol  force 

NGHT.TWO  nighttime  guard  patrol  procedures  w/  two  pattolling  forces 


t RE TURN  1  -  To  Continue 


.  .  . DONE 


Figure  7.4.2:  Guard  Submodel  Listing  -  Sample 


..  WV  J  V*.  “m  _  *  A  b  *  k  *  .  *  a%  -  e  *'» 


7.5  Delete  *  Guard  Submodel 


If  you  wish  to  delete  a  submodel  from  your  working  space, 
you  may  select  the  delete  option  on  the  'GUARD  MENU'. 


GUARD  MENU 


*  Create  a  guard  submodel 

*  Edit  a  guard  submodel 

*  Generate  SNAP  input  statements 

*  Li  at  guard  submodels 

*  Delete  «  suercl  submodel 

•Quit 


Figure  7.5.1:  Guard  Menu 

(Delete  a  guard  submodel) 


*  *■  ’ a  *  m  <  a,"  a  a  »  ■  »  *  0  '  .  a  .  •  .  •  .  'a  *  ,  _  »  ,  e  .  e  ,  r  r  •  • 
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You  may  then  select  which  submodel  you  wish  to  delete  from  a 


list  of  submodels.  You  will  be  asked  to  verify  your  selection. 


WORKING  SPACE I  EXAMPLE 


MAIN  <-  ESC  I 


GUARD  SUBMODEL  DELETION  MENU 


DESCRIPTION 


DAYJ3NE 
DAY_TWO 
NGHT  ONE 

nghtItwo 

QUIT 


guard  patrol  procedures  with  on*  patrolling  tore* 
Dayt  i  me  guard  patrol  procedur  e*s  with  two  patrolling  forces 
nighttime  guard  patrolling  procedures  w/  one  patrol  -force 
nighttime  guard  patrol  procedures  w/  two  patrolling  forces 
Quit  this  menu 


f  |  -  To  Choie 


t RE TURN 3  -  Make  Choice  ?  -  Help 


Figure  7.5.2:  Guard  Submodel  Deletion  Menu 


*ht  <-  esc 


GUARD  SUBMODEL  DELETION  HELP 


Use  the  arrow  keys  to  select  the  guard  submodel  you  wish  to  delete. 


CRETURN3  -  To  Conti nua 


.  .  . DONE 


Figure  7.5.2a:  Guard  Submodel  Deletion  Help 


7.6  Quit 


To  quit  working  with  the  guard  submodel,  select  the  quit 


option. 


WORKING  SPACE I  EXAMPLE 


SUBMODEL  <-E9C 


GUARD  MENU 


•  Create  a  guard  submodel 

•  Edit  a  guard  submodel 

•  Generate  SNAP  input  statements 

•  List  guard  ?ubmodels 

•  Delete  a  guard  submodel 


j  J  -  To  Choice 


t RETURN!  -  Mate  Choice  ?  -  Help 


Figure  7.6.1:  Guard  Menu 

(Quit) 
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8.0  GIVING  USER2  CONTROL 


To  give  User2  more  flexibility  during  the  analysis  of  his 
security  system,  you  can  allow  him  the  option  of  altering  some 

V 

of  the  data  elements  in  your  SNAP  model.  To  do  this,  you  must 
parameterize  your  model  and  build  the  prompt  query  databases. 


When  you  parameterize  your  model,  you  identify  those  data 
elements  that  User 2  wants  to  study  within  the  framework  of  the 
security  system  you  have  modeled.  The  prompt  query  databases 
provide  the  organization  for  the  prompts  and  the  allowed  responses 
User2  will  see  when  he  resolves  your  model.  For  each  parame¬ 
terized  submodel  there  is  a  Master  Prompt  Query  Database  and  a 
Prompt  Query  Set  Database.  The  Master  Prompt  Query  Database 
defines  the  complete  set  of  prompts  that  supports  the  submodel. 

The  Prompt  Query  Set  Database  defines  subsets  of  the  prompts  from 
which  User2  can  select  to  study  particular  aspects  of  the  security 
system.  These  subsets  are  defined  by  you,  perhaps  at  User2's 
request . 

8.1  Parameterizing  Your  Model  ' 

! 

Figure  8.1.1  shows  a  data  screen  for  a  guard  submodel  that 
has  been  parameterized.  The  ' @ 1  *  signifies  that  the  'Number  of 
guards  being  allocated'  field  will  be  replaced  by  User2's  response 
to  prompt  number  1  in  the  Master  Prompt  Query  Database.  In  a  like 
manner,  '@124'  is  associated  with  prompt  number  124.  ' 

I 

J 

l 

I 


The  number  of  data  elements  that  you  may  parameterize  is 
limited  to  the  number  of  digits  you  can  place  in  a  data  field. 

For  example,  a  data  field  five  spaces  wide  could  contain  the 
parameter  id,  @9999.  The  parameter  id's  do  not  need  to  be  in 
numeric  order  in  your  submodel  and  they  do  not  have  to  be  sequen¬ 
tial.  In  other  words,  you  can  enter  '@124'  in  one  field  and  '@1' 
in  the  next,  and  not  parameterize  any  other  data  elements  in  your 
model.  You  may  also  parameterize  mulitple  data  elements  with  the 

I  same  parameter  id.  User 2  will  be  prompted  once  per  session,  and 

his  response  will  be  used  everywhere  the  parameter  id  is  found  in 
your  model. 


_  NETWORK  <-  WK 

ALLOCATE  NODE  MENU 
Labvli  ALl  Comment!^  *  ^  5 

»•••  label  i Hi 

Number  of  guard*  being  al located! |St 
Maximum  number  of  branches  to  be  taken i  HH;:f 
Do  you  Nish  to  define  branches?  NO 

Enter  SAVE  to  save  current  values,  QUIT  to  exit  without  saving! 


f  |  -  To  Choice  ?  -  Help 


8.2  Building  the  Master  Prompt  Query  Databases 


The  Master  Prompt  Query  Database  contains  all  of  the  prompts 
(questions),  comments,  and  permitted  responses  that  will  be  issued 
during  a  User2  prompt-query  session.  You  need  to  build  one  Master 
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Prompt  Query  Database  for  every  submodel  that  you  parameterize. 

The  naming  convention  follows:  'submodel  name'.Xsq,  where  X  is  a 
'g'  for  a  guard  submodel,  'a'  for  an  adversary  submodel,  'c'  for  a 
control  submodel,  and  'd'  for  an  adversary  detection  submodel. 

The  Master  Prompt  Query  Database  associated  with  the  submodel 
containing  the  allocate  node  shown  in  Figure  8.1.1  is  shown  in 
Figure  8.2.1.  The  legend  for  Figure  8.2.1  identifies  each  of  the 
fields  of  the  Master  Prompt  Query  Database. 


eia,lb: 

lC,"OnER  SIZE  OF  GUARD  PATROL?" ,2d,l®,5f: 

@2a,0b; 

0,"  HG  -  HANDGUNS" ,1; 

0,"  SG  -  SHOTGUNS", 1; 

0,"  SA  -  SEMIAUTOMATICS" ,  1 ; 

0C,"  SM  -  SUBMACHINEGUNS" , 1 ; 

0,"  FA  -  FULLY  AUTOMATIC" ,1; 

0,"  NW  -  NO  WEAPONS", 1; 

0, "ENTER  THE  TYPE  OF  WEAPONS", 1; 

3,"  USED  BY  GUARD  PATROL  FORCE  ?" ,HGd,HG,SG,SA,SM,FA,NW; 

@3,1; 

2C, "ENTER  THE  PROFICIENCY  OF  THE  GUARD  PATROL?" ,50. 0d,0.0e, 100. 00f; 
@4,1; 


o 

** 

3 

HG  - 

HANDGUNS" ,0; 

o 

3 

SG  - 

SHOTGUNS", 0; 

0," 

SA  - 

SEMIAUTOMATICS" ,  0 ; 

O 

3 

SM  - 

SUBMACHINEGUNS", 0; 

o 

3 

FA  - 

FULLY  AUTOMATIC"  ,0; 

0," 

NW  - 

NO  WEAPONS", 0h; 

0, "ENTER  THE  TYPE  OF  WEAPONS", lh; 

3°, "  USED  BY  AUGMENTATION  FORCE  ?"  ,H3,HGg,SG9,SAg,SM9,FA9,NW9; 


Figure  8.2.1:  Prompt  Query  File  -  Sample 
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Legend  (Figure  8.2.1) 

a  -  Prompt  number,  corresponds  to  the  submodel, 
b  -  User  key,  identifies  the  question  as  being  restricted 
to  the  long  form  only  and  not  issued  on  the  short 
form; 

User  key  =  1,  prompt  is  issued  on  long  or  short  form. 

User  key  =  0,  prompt  is  issued  on  long  form  only, 
c  -  Question  type  code,  identifies  the  type  of  response 
that  is  expected  (alpha,  integer,  or  real); 

Question  type  code  =  0,  comment  line  which  preceeds 
the  prompt  with  which  it  should  be  issued. 

Question  type  code  *  1,  integer  response  expected. 

Question  type  code  =  2,  floating  point  response 
expected, 

Question  type  code  =  3,  alpha  response  expected, 
d  -  Prompt  default  value,  used  as  the  response  if  the 
prompt  is  not  issued. 

e  -  Lower  bound  of  response,  the  minimum  value  that  User 2 
can  supply  when  responding  to  this  prompt, 
f  -  Upper  bound  of  response,  the  maximum  value  that  User2 
can  supply  when  responding  to  this  prompt. 

2  -  Alpha  range  of  responses,  the  options  from  which 

User 2  may  choose  to  select. 

h  List  print  key  -  identifies  the  comment  print  or  no¬ 
print  status  when  a  response  set  is  listed; 

List  print  key  =  1,  comment  is  printed. 

List  print  key  =  0,  comment  is  not  printed. 

I 

1 
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The  Master  Prompt  Query  Database  was  designed  to  give  you 
control  over  how  the  menu  screen  that  will  contain  the  prompts  and 
permitted  responses  will  appear  to  User2.  Figure  8.2.2  shows  what 
User 2  will  see  when  he  is  prompted  for  parameter  id  Number  One.  As 
you  can  see,  you  will  want  to  limit  the  number  of  lines  of 
comments  that  you  write  so  as  to  keep  the  prompt  on  one  page. 

If  User2  enters  a  number  outside  the  permitted  range,  he 
will  be  told  he  is  outside  the  range  and  prompted  to  enter  another 
response.  The  alpha  range  of  responses  is  displayed  on  a  menu  in 
such  a  way  that  User2  will  use  the  arrow  keys  to  move  the  cursor 
to  the  desired  response. 


Figure  8.2.2:  User2  Prompt  Menu  -  Sample 


The  Master  Prompt  Query  Database  file  can  be  created  by  any 


word  processing  package,  such  as  WordStar 


The  format  you  need 


to  use  when  you  are  building  the  file  is  best  described  as  list- 
directed  input.  The  individual  fields  on  each  line  are  separated 


by  commas,  the  total  line  may  be  up  to  130  characters  long,  and 
the  line  must  end  with  a  semicolon. 

Since  you  will  test  your  model  before  you  hand  it  over  to 
User2,  you  will  be  able  to  do  any  fine-tuning  of  the  prompt's 
appearance  on  the  terminal  screen.  If  the  User2  Support  Program 
cannot  read  the  Master  Prompt  Query  Database  file,  it  will  note 
where  it  stopped  reading  the  file  and  write  a  debug  message  to  the 
file,  ' ERROR. RPT'  on  the  User2  subdirectory.  The  process  of 
building  the  User2  subdirectories  and  testing  your  submodel  is 
explained  in  detail  in  Sections  9.0  and  10.0. 

The  vast  majority  of  the  options  and  restrictions  on  the 
format  of  the  Master  Prompt  Query  Database  are  explained  in  the 
legend  accompanying  Figure  8.2.1.  The  remainder  of  this  section 
will  deal  with  some  of  the  finer  points  you  may  want  to  know. 

The  questions  and  comments  (See  Legend  for  Figure  8.2.1, 
item  c)  must  be  enclosed  within  double  quotes  and  can  be  up  to 
60  characters  long.  You  should  type  them  exactly  as  you  want 
them  to  appear,  including  question  marks,  periods,  and  other 
grammatical  notation. 

You  may  have  as  many  as  10  alpha  response  choices,  each  one 
up  to  8  characters  long.  However,  since  the  line  is  limited  to  130 
characters,  you  will  have  to  make  some  compromise  between  the  two 
limits.  You  may  try  entering  the  query  on  your  screen  as  a 
comment,  thus  allowing  you  to  enter  more  alpha  response  choices  on 
the  line  associated  with  the  question  code.  Or,  you  may 
abbreviate  the  responses  choices  and  explain  the  abbreviations  in 


^  t. 


the  comments,  as  is  shown  in  Figure  8.2.1.  In  the  majority  of 
instances,  you  will  never  be  limited  by  these  restrictions  because 
most  response  choice  lists  are  short  and  the  choices  are  seldom 
longer  than  two  character  each. 

The  user  key  (See  Legend  for  Figure  8.2.1,  item  b)  can  be 
used  to  isolate  a  set  of  prompts  within  the  Master  Prompt  Query 
Database  that  is  of  special  interest.  During  the  query- response 
session,  User2  will  select  to  review  either  the  long  or  the  short 
form  of  the  prompts.  Under  the  short  form,  the  prompts  with  user 
key  equal  to  0  will  not  be  asked. 

The  list  print  key  (item  h)  can  be  used  to  control  the 
amount  of  detail  that  User2  sees  when  the  responses  are  listed  for 
review.  After  User2  finishes  the  query-response  session  in  the 
User2  Support  Program,  he  can  list  the  comments,  prompts,  and 
responses  to  his  microcomputer  terminal.  As  shown  in  Figure 
8.2.1,  the  comments  are  often  repetitive.  By  setting  the  list 
print  key  equal  to  0  on  a  comment  line,  you  can  inhibit  the 
comment  from  being  printed  during  the  review. 

8.3  Building  the  Prompt  Query  Set  Databases 

A  Prompt  Query  Set  Database  identifies  the  sets  of  prompts 
for  a  single  parameterized  submodel  from  which  User2  may  choose. 
The  naming  convention  follows:  'submodel  name'.Xs_,  where  X  is 
'g'  for  a  guard  submodel,  'c'  for  a  control  submodel,  'd'  for  an 

I 

adversary  detection  submodel,  and  'a'  for  an  adversary  submodel. 
Figure  8.3.1  shows  the  Prompt  Query  Set  Database  associated  with 

i 
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the  submodel  and  Master  Prompt  Query  Database  shown  in  Figures 
8.1.1  and  8.2.1. 


PATROL4  Sets  the  characteristics  of  the  guard  patrol.13 
1,2,3, jC 

TOTAL3  Sets  patrol  characteristics  and  other  parameters.13 

1,2,3^ 

4; 

DEFAULT3  Automatically  select  default  parameters,  if  any  exist. b 


I 


$ 


Figure  8.3.1:  Prompt  Query  Set  -  Sample 

Legend  (Figure  8.3.1) 

a  -  Name  of  the  prompt  query  set. 

b  -  Description  of  the  prompt  query  set. 

c  -  List  of  the  prompt  numbers  that  should  be  issued  for  a 

prompt  query  set.  A  prompt  number  of  "0"  signifies 

that  the  default  values  should  be  used  and  no  prompts 
issued.  The  list  of  prompt  numbers  must  end  in  a 
The  list  of  prompt  numbers  can  be  provided  on  more 
than  one  line,  to  signify  continuation  end  the  line 
with  a  "/". 

The  advantage  of  setting  up  numerous  sets  within  the  Prompt 
Query  Set  Database  becomes  greater  as  the  number  of  prompts 
increases.  By  breaking  the  prompts  into  distinct  groups  you  can 
allow  User2  to  study  aspects  of  his  security  system,  such  as  the 
patrol  route  or  the  advesary  weaponry,  without  having  to  answer 
all  of  the  questions  each  time  he  creates  a  response  set.  The 
unasked  prompts  will  be  defaulted  when  the  model  is  resolved. 
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The  format  of  the  Prompt  Query  Set  Database  is  explained  in 
detail  in  the  legend  that  accompanies  Figure  8.3.1.  Each  line 
is  limited  to  80  characters.  The  line  that  contains  the  set  name 
and  description  should  be  entered  exactly  as  you  want  User2  to  see 
it.  The  prompt  numbers  should  be  separated  by  commas  and  end  with 
a  semicolon  (see  the  legend  for  details).  Up  to  ten  prompt  query 
sets  can  be  defined  in  the  Prompt  Query  Set  Database. 


All  guard,  adversary,  control,  and  adversary  detection  sub¬ 
models  must  have  an  associated  Prompt  Query  Set  Database  and 
Master  Prompt  Query  Database.  If  the  submodel  has  not  been  para¬ 
meterized  and  therefore  requires  no  prompts,  the  Master  Prompt 
Query  Database  file  is  empty  and  the  Prompt  Query  Set  Database 
should  show  one  prompt  query  set  with  the  question  list  showing 
only  a  "0".  This  is  similar  to  the  last  set  shown  in  Figure 
8.3.1. 
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9.0  SETTING  UP  THE  SNAP-PC  SUBDIRECTORY 

Before  you  can  test  your  model  and  before  User2  can  perform 
analyses  with  your  model,  you  must  set  up  a  User 2  work  area  or 
subdirectory  and  move  the  model  into  that  subdirectory. 


9.1  User2  Subdirectory  Structure 


The  structure  of  the  User2  Subdirectory  is  similar  to  the 


Userl  working  space.  Figure  9.1.1  shows  the  SNAP-PC  subdirectory 
tree  structure  using  sample  User 2  subdirectories,  U2_user  and 


U2_exmpl . 


c:\SNAP 


U2_exmpl  ...  j 


files: 

CONTROL. SO 

day .GSM 

ADD. SO 

day.GSQ 

GUARD . SO 

day.GS 

ADVERS . SO 

night. GSM 

FACILITY.NET 

night .GSQ 

CONTROL. CSM 

night .GS 

CONTROL. CSQ 

att  air. ASM 

CONTROL.CS 

att  air.ASQ 

detl.DSM 

att  air. AS 

detl.DSQ 

att  grd.ASM 

detl.DS 

att_grd. ASQ 

det2 . DSM 

att  qrd.AS 

det2 . DSQ 

• 

det2.DS 

• 

• 

• 

Figure  9.1.1:  User2  Subdirectory  Structure  Sample 


All  of  the  characters  in  lower  case  are  examples  of 
subdirectory  or  file  names  that  you  will  supply.  In  the  main 


directory  (C:\SNAP)  the  file  USERS. S0_  must  contain  a  list  of  the 

User2  subdirectories  and  a  description  of  each.  For  this  example/ 

USERS. S0_  is  shown  in  Figure  9.1.2.  The  contents  of  USERS. S0_ 

are  displayed  when  User2  is  asked  to  select  a  user  subdirectory. 

TM 

It  can  be  created  with  a  text  editor  such  as  WordStar 


user  User  work  space  for  SNAP-PC  course  May  1986 
exmpl  Example  work  space 


Figure  9.1.2:  File  USERS. S0_  Sample 

In  a  similar  manner  the  file  FACILITY. S0_  under  each  User2 
subdirectory,  contains  the  list  of  facilities  or  models  that 
reside  under  the  subdirectory.  Figure  9.1.3  displays  an  example 
of  this  file  for  user  subdirectory  U2_user. 


example  Sample  facility  from  SNAP  User's  Manual,  August  1986 
class  SNAP-PC  class  example  model 

big_sol  SNAP-PC  class  big  model 


Figure  9.1.3:  File  FACILITY. S0_  Sample 


The  facility,  or  model,  subdirectory  contains  all  the  files 
and  submodels  necessary  to  perform  the  SNAP  analyses.  The  file 
FACILITY.NET  contains  the  SNAP  statements  representing  your  faci¬ 
lity  submodel.  In 'this  form  it  is  ready  to  be  joined  with  the 
other  submodels  and  used  in  a  SNAP  analysis. 

Those  files  in  the  subdirectory  whose  extension  begins  with 
‘C  correspond  to  the  control  submodel.  CONTROL. CSM  contains  the 
SNAP  input  statement  for  the  submodel,  CONTROL. CSQ  contains  the 
Master  Prompt  Query  Database  for  the  submodel,  and  CONTROL. CS_ 
contains  the  Prompt  Query  Set  Database. 

The  same  convention  follows  for  the  adversary  detection, 
guard,  and  adversary  submodels.  Those  files  whose  extension 
begins  with  'D'  correspond  to  the  adversary  detection  submodels, 
those  files  whose  extension  begins  with  'G'  correspond  to  the 
guard  submodels,  and  those  files  whose  extension  begins  with  'A* 
correspond  to  the  adversary  submodels.  Note  that  the  adversary 
detection,  guard,  and  adversary  submodels  are  named  by  you  when 
you  create  them  using  the  Userl  Support  Program  and  that  more  than 
one  of  each  may  exist. 

The  files  CONTROL. S0_,  ADD.SO_,  GUARD. S0_  and  ADVERS.SO_ 
contain  lists  of  the  names  and  descriptions  of  the  control,  adver¬ 
sary  detection,  guard  and  adversary  submodels  that  you  created 
with  the  Userl  Support  Program.  Since  there  is  only  one  Control 
Submodel  per  model,  the  file  CONTROL. S0_  must  be  created  but  the 
others  already  exist  in  your  working  space.  Figures  9.1.4 
through  9.1.7  show  examples  of  these  files. 
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CONTROL  Control  Submodel  for  SNAP  Example 


Figure  9.1.4s  File  CONTROL. S0_  Sample 


detl 

Detection 

using  one  sensor 

det2 

Detection 

using  three  sensors 

• 

• 

• 

■ 

• 

• 

Figure  9.1.5s  File  ADD.SO_  Sample 


day  one 

Daytime  guard  patrol  procedures  with  one 

patrolling  force 

nqht  one 

Nighttime  guard  patrolling  procedures  with 

one  patrol  force 

nght  two 

Nighttime  guard  patrol  procedures  with  two 

patrolling  forces 

day  two 

Daytime  guard  patrol  procedures  with  two 

• 

• 

• 

patrolling  forces 

• 

• 

• 

Figure  9.1.6s  File  GUARD. S0_  Sample 


att_air  Adversary  attack  from  the  air 

att_grd  Adversary  attack  from  the  ground 


Figure  9.1.7s  File  ADVERS.SO_  Sample 
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9.2  Moving  Your  Model  to  a  User 2  Subdirectory 


Your  first  steps  to  moving  your  model  to  a  User2  Subdirec¬ 
tory  is  to  create  the  necessary  subdirectories  in  the  form  shown 
in  Figure  9.1.1.  If  you  are  placing  the  model  into  a  new  user 
area,  you  will  need  to  make  the  new  user  subdirectory  and  create 
or  supplement  the  file  USERS. S0_  with  the  name  of  the  new  user 
subdirectory,  i.e.,  user  for  subdirectory  U2_user.  If  you  are 
placing  the  model  in  an  existing  User2  subdirectory,  you  will  not 
need  to  create  the  subdirectory  or  alter  the  USERS. S0_  file.  The 
standard  DOS  command  for  making  a  subdirectory  is  tmkdir  'sub¬ 
directory  name'].  This  should  be  done  from  within  the  parent 
directory.  (After  creating  a  subdirectory,  it  may  be  entered  from 
the  parent  directory  by  typing  [cd  'subdirectory  name']. 

If  you  are  moving  a  new  model  into  the  User2  area,  you  will 
need  to  make  the  model  subdirectory  under  the  User2  subdirectory 
and  augment  or  create  the  FACILITY. S0_  file  to  reflect  the  new 
model.  In  the  sample  structure  shown  in  Figure  9.1.1  one  model 
subdirectory  is  EXAMPLE.  If  you  are  supplementing  a  model  that 
already  exists  in  the  desired  User2  Subdirectory,  you  will  not 
need  to  create  the  new  model  subdirectory  or  alter  the  USERS. S0_ 
or  FACILITY. S0_  files. 

After  you  have  created  the  necessary  subdirectories  you  are 
ready  to  copy  the  submodels  and  supporting  files  into  the  facility 
subdirectory.  This  is  done  by  using  the  DOS  copy  commands  [copy 
'old  file  name'  'new  file  name'].  Typically,  the  copy  command 
file  name  includes  the  path  or  subdirectory  tree  structure.  You 
will  find  the  submodels  you  created  on  the  path  C:\SNAP\USER1\XXX 
where  XXX  is  the  name  of  your  Userl  model  working  space.  To 


>> 


support  animation  you  will  also  need  the  facility  schematic  in 
file  ' FACILITY. FPB'  to  be  placed  in  the  model  subdirectory.  In 
addition,  the  Userl  subdirectory  contains  the  files  ADD.SO_, 

GUARD. S0_  and  ADVERS.SO_.  After  copying  them  you  may  need  to 
alter  them  to  satisfy  User2's  needs.  You  will  need  to  create 
CONTROL. S0_  for  User 2.  The  Master  Prompt  Query  Database  files  and 
Prompt  Query  Set  Database  files  must  also  be  placed  in  the 
facility  subdirectory.  You  must  create  them  using  a  text  editor; 
hence,  you  may  wish  to  create  them  in  the  facility  subdirectory. 

After  structuring  the  subdirectories  as  described  in  Section 
9.1  and  placing  the  submodels  in  the  facility  subdirectory,  you 
are  ready  to  begin  testing  your  model.  Section  10.0  describes  the 
testing  process. 
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10.0  TESTING  YOUR  MODEL 


To  test  your  model  you  must  first  set  up  a  User2 
subdirectory.  Section  9.0  gives  you  detailed  instructions  for 
setting  up  this  subdirectory.  j 

10.1  Executing  the  User2  Support  Program  ! 

You  must  execute  the  User2  Support  Program  in  order  to  test  | 

t 

your  model.  To  run  your  model,  you  must  go  through  the  process  of  ] 

selecting  the  submodels  that  you  want  to  use.  This  process  is  ! 

t 

detailed  in  the  User2  manual,  Evaluating  Security  Systems  Using  \ 

SNAP-PC  and  will  not  be  repeated  here.  If  you  follow  the  sug-  j 

gested  modeling  approach  in  Section  1.0,  you  will  debug  your  model 
prior  to  parameterizing  it.  Therefore,  when  you  select  the  sub¬ 
models,  you  will  only  have  the  default  prompt  response  option 
available  when  you  select  the  prompt-query  set  for  each  submodel. 

This  will  eliminate  the  need  to  build  a  response  set  at  this  time. 

I 

You  may  wish  to  reference  Sections  8.0  and  9.0  concerning  setting  j 

up  prompt  query  files  for  a  better  understanding  of  the  default 
prompt  response  option. 

Once  you  have  selected  all  four  submodels,  you  may  attempt  ! 

to  execute  a  run.  When  you  select  the  execute  option  on  the 
User2  'OPTION  SELECTION  MENU',  you  will  be  asked  to  supply  infor¬ 
mation  concerning  the  run.  This  includes  tracing  information 
which  is  vital  to  debugging  models.  For  a  complete  explanation  of 
the  User2  Support  Program  you  should  reference  the  manual 
Evaluating  Safeguards  Systems  Using  SNAP-PC. 


10.2  Debugging  Your  Model 


When  you  begin  the  debugging  process,  it  is  a  good  idea  to 
have  the  echo  check  option  on  the  SNAP  information  statement  in  the 
Control  Submodel  set  to  (C)omplete.  This  will  be  helpful  in 
debugging  SNAP  input  errors.  Input  errors  are  associated  with  the 
SNAP  statements,  and  if  they  occur,  the  simulation  cannot  begin. 
Appendix  G  in  the  SNAP  User's  Manual  has  a  list  of  non-fatal  and 
fatal  input  errors.  After  you  have  corrected  the  input  errors, 
you  should  set  the  echo  check  option  to  (N)one. 

Now  that  the  input  errors  have  been  corrected,  the  execution 
of  the  simulation  will  be  attempted.  While  it  is  executing,  run 
time  errors  may  be  detected.  A  list  of  these  errors  is  given  in 
Appendix  G  of  the  SNAP  User's  Manual.  If  an  error  occurs,  you  may 
be  able  to  determine  from  the  error  message  what  has  caused  the 
problem.  However,  more  times  than  not,  the  problem  will  have  to 
be  investigated  before  the  cause  can  be  determined.  The  text 
trace  and  the  animation  are  good  tools  to  use  to  speed  your  inves¬ 
tigation.  These  give  you  a  time  sequenced  account  of  the  events 
which  occurred  during  the  simulation  prior  to  the  time  of  failure. 

10.3  Verification  and  Validation  of  Your  Model 

Once  the  model  has  been  debugged,  you  must  verify  and  vali¬ 
date  the  performance  of  the  model.  Verification  consists  of 
determining  if  the  model  executes  on  the  computer  as  you  intended. 
Validation  is  the  task  of  determining  if  your  model  is  a  reason¬ 
able  representation  of  your  system.  This  involves  a  comparison  of 
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model  and  system  structure  along  with  a  validation  check  on  input 
data . 


10.4  Debugging  Your  Prompt  Query  Databases 


After  you  have  debugged  your  model,  you  may  parameterize  it 
for  User2.  Once  the  model  is  parameterized,  you  must  again  move 
it  over  to  a  User2  subdirectory  to  test.  The  testing  includes 
debugging  the  prompt  query  databases  you  created  when  you  para¬ 
meterized  the  model.  To  test  a  prompt  query  database  you  should 
go  through  the  User2  shell  and  try  to  create  a  response  set.  If 
there  is  an  error  in  the  Master  Prompt  Query  Database  or  the 
Prompt  Query  Set  Database,  a  message  will  be  displayed  on  the 
screen  at  the  time  you  select  the  prompt  query  database.  To  help 
in  debugging  these  errors  the  file,  'ERROR. RPT'  is  created  in  the 
User2  subdirectory  containing  information  describing  the  errors. 
Fix  the  error  that  is  identified  and  try  again  to  create  a  res¬ 
ponse  set.  Every  prompt  file  you  create  should  be  tested  in  the 
same  manner. 


11.0  PREPARING  THE  MODEL  FOR  0SER2 

Now  that  you  have  completed  testing  your  model  and  feel 
comfortable  with  the  analyses  that  can  be  done  with  it,  you  are 
ready  to  make  it  available  for  User2.  In  addition  to  installing 
the  model  in  User2's  subdirectory,  you  must  provide  enough  infor¬ 
mation  to  insure  effective  analysis  with  the  model. 

11.1  Docuaienting  the  Model 

You  should  document  the  model  to  support  a  clear  understand¬ 
ing  of  the  activities  and  interactions  in  the  system  and,  hence, 
support  (Jser2's  efforts  to  draw  accurate  conclusions  from  the  SNAP 
analysis.  Each  submodel  should  be  supported  with  a  list  of  model¬ 
ing  assumptions  and  a  description  of  the  model  logic.  Specifi¬ 
cally,  a  discussion  of  the  differences  between  submodels  of  the 
same  type  should  be  documented. 

In  addition,  you  should  document  the  Master  Prompt  Query 
Databases  and  Prompt  Query  Set  Databases.  This  should  include  a 
description  of  the  use  of  each  parameter  and  the  implication  of 
changing  its  value.  The  default  values  and  the  range  of  accept¬ 
able  values  should  also  be  discussed.  The  prompt  query  sets 
should  be  documented  to  support  User2's  selection.  This  will 
insure  User2's  understanding  the  parameters  for  which  he  will  be 
prompted  and  the  default  values  that  will  be  used  for  the  prompts 
that  are  not  issued. 


Your  documentation  should  also  include  an  estimate  of  the 
minimum  number  of  iterations  of  the  simulation  that  should  be 
executed  and  an  estimate  of  the  length  of  time  it  will  take  to  run 
each  iteration  on  an  IBM  PC  AT.  These  topics  will  be  discussed  in 
Sections  11.2  and  11.3.  Appendix  C  provides  sample  documentation 
for  the  model  that  has  been  shown  throughout  this  manual. 

11.2  Computing  the  Number  of  Iterations  That  Must  Be  Run 

The  number  of  iterations  of  the  simulation  is  proportional 
to  the  level  of  accuracy  or  confidence  you  desire  from  the 
analysis.  The  more  iterations  that  are  executed,  the  greater  the 
likelihood  that  the  performance  measures  of  the  simulation  (proba¬ 
bility  of  system  win)  accurately  reflect  the  modeled  system.  For 
instance,  if  the  analysis  predicts  the  probability  of  system  win 
to  be  .90  after  20  iterations,  you  can  be  54%  confident  that  the 
true  probability  lies  between  .85  and  .95.  Whereas,  if  the  analy¬ 
sis  is  performed  with  100  iterations  and  the  probability  of  system 
win  is  .90,  you  can  be  90%  confident  that  the  true  probability 
lies  between  .85  and  .95.  Table  11.2.1  shows  the  relationship 
between  the  number  of  iterations  that  are  performed  and  the  level 
of  confidence  that  you  can  have  in  the  performance  measures  of  the 
analysis . 


Table  11.2.1  Number  of  Iterations  Versus  Confidence  Level 

Confidence  Interval 


# 


Iterations 

Probability 

Of  System  Win 

On  Probability 

Of  System  Win 

Confidence 

Level 

10 

.1 

.05 

.15 

40« 

.3 

.25 

- 

.35 

28% 

.5 

.45 

- 

.55 

25% 

.7 

.65 

- 

.75 

28% 

.9 

.85 

- 

.95 

40% 

20 

.1 

.05 

— 

.15 

54% 

.3 

.25 

- 

.35 

37% 

.5 

.45 

- 

.55 

35% 

.7 

.65 

- 

.75 

37% 

.9 

.85 

- 

.95 

54% 

30 

.1 

.05 

— 

.15 

65% 

.3 

.25 

- 

.35 

45% 

.5 

.45 

- 

.55 

42% 

.7 

.65 

- 

.75 

45% 

.9 

.85 

— 

.95 

65% 

40 

.1 

.05 

— 

.15 

69% 

.3 

.25 

- 

.35 

51% 

.5 

.45 

- 

.55 

46% 

.7 

.65 

- 

.75 

51% 

.9 

.85 

.95 

69% 

50 

.1 

.05 

.15 

75% 

.3 

.25 

- 

.35 

55% 

.5 

.45 

- 

.55 

53% 

.7 

.65 

- 

.75 

55% 

.9 

.85 

- 

.95 

75% 

60 

.1 

.05 

— 

.15 

80% 

.3 

.25 

- 

.35 

60% 

.5 

.45 

- 

.55 

55% 

.7 

.65 

- 

.75 

60% 

.9 

.85 

- 

.95 

80% 

80 

.1 

.05 

— 

.15 

85% 

.3 

.25 

- 

.35 

67% 

.5 

.45 

- 

.55 

63% 

.7 

.65 

- 

.75 

67% 

.9 

.85 

- 

.95 

85% 

100 

.1 

.05 

_ 

.15 

90% 

.3 

.25 

- 

.35 

70% 

.5 

.45 

- 

.55 

69% 

.7 

.65 

- 

.75 

70% 

.9 

.85 

- 

.95 

90% 

204 


Table  11.2.1  Number  of  Iterations  versus  Confidence  Level 

(continued) 


Iterations 

200 


Probability 
Of  System  Win 


Confidence  Interval 
On  Probability 
Of  System  Win 


Confidence 
Level 


.1 

.05 

- 

.15 

.3 

.25 

- 

.35 

.5 

.45 

- 

.55 

.7 

.65 

- 

.75 

.9 

.85 

- 

.95 

.1 

.05 

— 

.15 

.3 

.25 

- 

.35 

.5 

.45 

- 

.55 

.7 

.65 

- 

.75 

.9 

.85 

- 

.95 

99.5% 
93.0% 
91.5% 
93.0% 
99.5% 


From  your  understanding  of  the  system  and  the  information 
supplied  in  Table  11.2.1,  you  should  guide  User 2  in  his  decision 
of  the  number  of  iterations  to  perform. 

11.3  Length  of  a  Run 

To  assist  User2  in  his  efforts  to  use  his  PC  effectively, 
you  should  estimate  the  minimum  and  maximum  time  it  will  take  to 
simulate  one  iteration  of  the  SNAP  model.  At  the  time  User2 
starts  a  SNAP  analysis,  the  numbers  you  have  provided  will  be 
multiplied  by  the  number  of  iterations  he  has  requested  to 
estimate  the  length  of  time  the  PC  will  be  occupied  executing  the 
run.  The  time  estimates  are  reported  to  the  user  and  he  is  given 
the  chance  to  abort  the  run  and  possibly  execute  it  at  another 
time.  The  minimum  and  maximum  time  estimates  should  be  determined 
by  clocking  several  runs  of  the  model.  After  you  have  made  the 
estimates,  you  should  edit  the  'general  run  information'  in  the 
control  submodel  to  reflect  these  values. 
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GLOSSARY 


Adversary  Detection  Submodel  -  The  adversary  detection  submodel 
describes  the  sensor  system  present  at  the  facility. 
This  would  include  the  sensors,  logic  points,  and 
monitor  point. 

Adversary  Submodel  -  The  adversary  submodel  defines  the  attack 
process  that  the  adversary  forces  will  use  to  reach 
their  objective. 

Case  -  See  Run. 

Control  Submodel  -  The  control  submodel  defines  and  initializes 
the  variables  that  are  used  in  other  portions  of  the 
model  to  control  actions  within  the  simulation. 

These  variables  are  often  referred  to  as  global 
variables . 

Facility  Submodel  -  Typically,  a  facility  environment  consists  of 
buildings,  doorways,  fences,  open  spaces,  etc.  The 
facility  submodel  defines  the  environment  and  the 
relationships  between  the  pieces  of  the  environment. 

Global  Variable  -  See  Control  Submodel. 

Guard  Submodel  -  The  guard  submodel  outlines  the  guard  actions 

during  normal  patrols  and  when  the  facility  is  under 
attack. 

Iteration  -  An  iteration  is  one  execution  of  the  simulation  where 
only  one  set  of  random  numbers  is  used.  Typically,  a 
SNAP  analysis  run  includes  several  iterations. 

Master  Prompt  Query  File  -  The  Master  Prompt  Query  File  is 

created  by  Userl  and  contains  the  complete  set  of 
prompts  that  may  be  issued  during  a  query-response 
session  for  a  submodel.  The  naming  convention  for 
the  Master  Prompt  Query  File  is  as  follows:  submodel 
name.Xsq,  where  X  is  'g1  for  a  guard  submodel,  'a’ 
for  an  adversary  submodel,  'c'  for  a  control  sub¬ 
model,  and  'd'  for  an  adversary  detection  submodel. 

Model  -  A  model  is  a  description  of  the  security  system  that 
is  being  analyzed.  For  the  purpose  of  SNAP  analysis 
a  model  will  include  a  description  of  the  facility 
(or  environment)  to  be  analyzed,  descriptions  of  the 
possible  guard  and  adversary  movement,  descriptions 
of  the  possible  detection  systems  at  the  facility, 
and  definition  of  the  model  controlling  variables 
that  will  affect  the  SNAP  analysis. 

Parameterization  -  Parameterization  is  the  process  of  building  a 

model  with  missing  data  elements,  that  can  be  supplied 
at  a  later  time  by  User2. 


Prompt  Query  Set  -  A  Prompt  Query  Set  defines  subsets  of  the 

queries  in  the  Master  Prompt  Query  File.  The  subsets 
are  identified  by  name  to  User 2  and  defined  by  Userl. 
The  naming  convention  for  the  files  associated  with 
the  Prompt  Query  Sef  is  as  follows:  submodel 
name.Xs_,  where  X  is  'g'  for  a  guard  submodel,  ' c' 
for  a  control  submodel,  'a'  for  an  adversary  sub¬ 
model,  and  'd'  for  an  adversary  detection  submodel. 

Prompt  Response  Set  -  The  Prompt  Response  Set  contains  the 
responses  that  User2  has  given  during  a  query- 
response  session. 


Run  -  A  run  is  an  execution  of  a  SNAP  analysis  using  one  of 

each  of  the  five  submodels. 

Sensitivity  Analysis  -  Sensitivity  Analysis  is  the  process  of 
evaluating  the  sensitivity  of  the  system's  per¬ 
formance  to  changes  to  procedures,  task  times,  etc. 
This  is  done  by  executing  the  SNAP  analysis  under  a 
variety  of  responses  to  the  prompts,  usually  varying 
only  one  parameter  at  a  time. 

SNAP  -  SNAP  (Safeguards  Network  Analysis  Procedure)  is  a 

simulation  based  analysis  technique  used  to  evaluate 
fixed  site  security  systems. 

SNAP-PC  -  SNAP-PC  is  a  combination  of  programs  useable  on  IBM- 
PC  compatible  micro-computers.  These  programs 
include  SNAP,  a  Userl  interface  program  and  a  User2 
interface  program.  The  Userl  interface  program 
supports  the  development  of  SNAP  models.  The  User2 
interface  program  supports  the  analysis  of  SNAP 
models . 


Submodels  - 


Userl 


User2 


-  Submodels  are  components  of  a  model.  Five  different 
types  of  submodels  comprise  a  SNAP-PC  model.  They 
are  the  facility  submodel,  the  control  submodel, 
adversary  detection  submodels,  guard  submodels,  and 
adversary  submodels.  A  SNAP  analysis  or  run  is  com¬ 
prised  of  one  of  each  of  the  five  submodels. 

-  Userl  is  a  SNAP-PC  user  who  is  responsible  for 
building  models  and  developing  Prompt  Query  Sets  for 
the  models  he  has  developed. 

-  User2  is  a  SNAP-PC  user  who  is  interested  in 
performing  SNAP  analyses  on  a  security  system. 


User2  Subdirectory  -  The  User2  Subdirectory  is  the  directory  that 
has  been  defined  for  a  specific  user.  Typically  it 
will  be  named  to  correspond  to  the  user's  name,  i.e., 
Mark,  Smith.  A  User2  subdirectory  can  contain  one  or 
more  models.  The  User2  subdirectories  were  estab¬ 
lished  so  that  a  user  can  work  with  a  model  without 
disturbing  the  work  of  other  users  with  access  to  the 
same  micro-computer. 
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Working  Space  -  A  working  apace  ia  the  area  that  ia  uaed  by  Uaerl 
to  build  and  define  a  model,  within  the  computer,  the 
working  apace  ia  a  aubdi rectory.  Bach  working  apace 
containa  only  one  facility  submodel  and  only  one  con¬ 
trol  submodel  and  any  number  of  guard,  adversary  and 
adversary  detection  submodels.  Typically  the  working 
space  name  correseponds  to  the  name  of  the  facility. 
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APPENDIX  A 


NODES  AND  STATEMENTS  FOR  EACH  SUBMODEL 


Control  Submodel 


General  Run  Information  Statement  -  one  required 


Parameter  Statements 

- 

as 

many 

as 

needed 

Global  Variable  Statements 

- 

as 

many 

as 

needed 

Global  Flag  Statements 

- 

as 

many 

as 

needed 

Force  Flag  Statements 

- 

as 

many 

as 

needed 

Macro  Statements 

- 

as 

many 

as 

needed 

Timer  Statements 

- 

as 

many 

as 

needed 

Facility  Submodel 

Space  Nodes 

- 

as 

many 

as 

needed 

Barrier  Nodes 

- 

as 

many 

as 

needed 

Target  Nodes 

- 

as 

many 

as 

needed 

Adversary  Detection  Device  Submodel 

Sensor  Nodes 

- 

as 

many 

as 

needed 

Logic  Nodes 

- 

as 

many 

as 

needed 

Monitor  Nodes 

- 

as 

many 

as 

needed 

Guard  Submodel 

Engagement  Statements 
Combinations  Statements 
BASE  Statements 
PENG  Statements 

DENG  Statements 
Enter  Nodes 


one  required 

one,  as  required 

as  many  as  needed 

as  many  as  needed 
in  specific  order 

as  many  as  needed 

as  many  as  needed 


Allocate  Nodes 


as  many  as  needed 


RTB  Nodes 


Wait  Nodes 
Task  Nodes 
Signal  Nodes 
Exit  Nodes 
Branch  Types 
Regular 
Decision 
Probabilistic 

Adversary  Submodel 

Engagement  Statement 
Combinations  Statement 
Objective  Statement 
PENG  Statements 

DENG  Statements 
Enter  Nodes 
Wait  Nodes 
Task  Nodes 
Signal  Nodes 
Exit  Nodes 
Branch  Types 
Regular 
Decision 
Probabilistic 


-  as  many  as  needed 
as  many  as  needed 
as  many  as  needed 
as  many  as  needed 
as  many  as  needed 
as  many  as  needed 


one  required 

one,  as  required 

one  required 

as  many  as  needed 
in  specific  order 

as  many  as  needed 

as  many  as  needed 

as  many  as  needed 

as  many  as  needed 

as  many  as  needed 

as  many  as  needed 

as  many  as  needed 
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MODELING  LIMITED  AMMUNITION  SUPPLY 


Modeling  limited  ammunition  supply  has  been  identified  as  an 
immediate  need  of  the  current  SNAP-PC  users.  This  is  not  explic¬ 
itly  designed  into  SNAP  but  can  be  modeled  in  two  fashions  with 
the  PENG  and  DENG  statements.  Using  one  approach,  the  force  that 
has  exhausted  their  ammunition  supply  will  be  fired  upon  at  an 
increased  rate;  in  the  other,  they  will  be  fired  upon  at  the  same 
rate  as  when  they  are  loading  their  weapons. 

For  both  approaches  one  or  several  PENG  statements  must  be 
used  to  represent  the  period  of  time  that  the  force  has  ammunition 
followed  by  a  PENG  statement  defining  the  length  of  time  the  force 
is  without  ammunition.  You  can  model  a  scenario  where  a  force 
runs  out  of  ammunition  by  specifying  a  length  of  time  greater  than 
the  length  of  the  simulation  run.  A  shorter  duration  can  be  used 
to  model  getting  ammunition  from  casualties  or  another  source. 

The  DENG  statement  associated  with  the  lack  of  ammunition 
time  period  should  either  show  a  suppression  status  of  'yes'  or  a 
percent  time  delay  of  '100'.  If  a  suppression  status  of  'yes'  is 
specified,  the  force  will  not  fire  during  the  time  period  and  the 
opposing  force  will  fire  at  an  increased  rate.  If  the  percent 
time  delay  is  '100',  the  force  will  not  fire  and  their  exposure  is 
the  same  as  their  exposure  while  loading. 

With  either  approach,  you  will  be  able  to  study  the  effects 
of  limited  ammunition  supply.  This  aspect  becomes  increasingly 
important  as  the  length  of  individual  engagements  or  the  number  of 
engagements  increases. 


DOCUMENTATION  OF  SAMPLE  MODEL 


This  model  is  based  on  a  SNAP  example  first  presented  in 
Chapter  IX  of  the  SNAP  User's  Manual.  The  model  includes  a  small 
facility  with  only  one  building  and  one  target.  The  model  in¬ 
cludes  two  alternative  sensor  submodels,  four  guard  submodels  and 
two  adversary  attack  submodels.  Preliminary  analysis  with  this 
model  shows  that  at  least  100  iterations  should  be  executed  to 
insure  accurate  interpretation  of  the  model  outputs. 

Facility  Submodel 

The  facility  consists  of  a  building  with  one  entrance  sur¬ 
rounded  by  a  patrolled  area.  Figure  C.l  shows  the  facility  sub¬ 
model.  Space  nodes  II  through  15  represent  the  areas  of  interior 
patrols.  Space  nodes  01  through  05  represent  the  areas  of  the 
exterior  patrols;  barrier  Dl  is  the  doorway  to  the  building. 

Target  node  TARl  represents  the  target  with  a  sensor,  S2.  Ex¬ 
terior  space  nodes  01  and  03  also  have  sensors.  Space  and  barrier 
nodes  LADR,  ROOF,  and  CUT  are  used  to  describe  the  path  an  adver¬ 
sary  will  take  as  he  tries  to  reach  the  target. 
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Figure  C.l:  Facility  Submodel 
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Control  Submodel 


The  control  submodel  defines  the  data  distributions  that  are 
used  by  the  model  and  the  global  variables.  The  control  submodel 
was  not  parameterized  and,  therefore,  has  no  prompts.  The  data 
that  is  defined  in  the  control  submodel  will  be  discussed  in  the 
following  sections. 


Adversary  Detection  Submodel 


Two  adversary  detection  submodels  have  been  developed  to 
support  this  model.  The  first  is  DET1  and  includes  only  one 
active  sensor  (S2)  and  one  monitor  point  (Ml).  Figure  C.2  shows 
this  adversary  detection  submodel.  Sensor  nodes  SI  and  S3  are 
included  in  the  diagram,  but  do  not  affect  the  simulation  of  the 
model.  The  second  adversary  detection  submodel,  DET2 ,  includes 
two  additional  active  sensors  on  exterior  space  nodes  01  and  03. 
Figure  C.3  shows  this  adversary  detection  submodel. 
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Figure  C.2:  Adversary  Detection  Submodel 


Associated  with  both  submodels  are  prompt  query  sets 
allowing  you  to  define  the  probability  of  sensor  detection  and  the 
signal  persistence  as  permanent  or  temporary.  The  default 
probability  of  detection  for  all  sensors  is  .95  and  the  default 
signal  persistence  for  all  sensors  is  permanent. 

Submodel  DET1  has  only  two  prompt  query  sets:  SENSORS  or 
DEFAULT.  SENSORS  prompts  for  both  the  probability  of  detection 
and  the  signal  persistence  for  sensor  S2.  Selecting  DEFAULT 
causes  the  default  responses  for  both  prompts  to  be  used  to  re¬ 
solve  the  model. 


Submodel  DET2  has  four  prompt  query  sets:  SENSORS,  EXTER, 
INTER  or  DEFAULT.  SENSORS  issues  prompts  for  all  three  sensors. 
EXTER  prompts  only  for  information  associated  with  sensors  SI 
and  S3.  INTER  prompts  only  for  information  for  sensor  S2. 
DEFAULT  does  not  issue  any  prompts  and  uses  the  default  values 
for  all  responses. 
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guard  Submodel 


Four  guard  submodels  have  been  developed  to  support  the 
analysis.  In  general  the  guards  patrol  the  inside  and  outside  of 
the  building.  Normal  interior  patrolling  is  accomplished  by 
traveling  through  spaces  II  through  15  in  either  a  clockwise  or 
counterclockwise  direction  (chosen  randomly).  The  time  to  travel 
through  each  space  is  triangularly  distributed  with  a  minimum  of 
one,  mode  of  1.5,  and  maximum  of  2.5.  If  adversaries  are  de¬ 
tected,  the  guards  double  their  rate  of  travel.  Normal  exterior 
patrolling  is  accomplished  by  traveling  through  spaces  01  through 
05  in  either  a  clockwise  or  counterclockwise  direction  (chosen 
randomly).  The  time  to  travel  through  each  space  is  triangularly 
distributed  with  a  minimum  of  two,  mode  of  2.5,  and  maximum  of 
3.5.  If  adversaries  are  detected,  the  guards  double  their  rate  of 
travel . 


Guard  submodel  DAY  ONE  includes  a  single  patrol  that  patrols 
both  the  exterior  and  interior  of  the  building.  In  addition,  if  a 
sensor  is  triggered,  the  guard  force  hears  it  whether  they  are  on 
interior  or  exterior  patrol.  The  prompts  define  the  number  in  the 
patrolling  force,  the  weaponry  they  carry  and  their  proficiency. 

In  addition,  the  prompts  define  the  weaponry  used  by  the 
augmentation  force.  Table  C.l  shows  the  default  values  for  each 
prompt . 


Table  C.l 


Guard  Submodel  DAY_ONE 
Prompts 


Prompt 

Size  of  Patrol 
Patrol  Weaponry 
Patrol  Proficiency 
Augmentation  Force  Weaponry 


Default  Value 
2 

Handguns 

50% 

Handguns 


Three  prompt  query  sets  allow  selection  of  the  patrol 
prompts,  excluding  augmentation  force  weaponry;  all  prompts;  or  a 
default  set,  issuing  no  prompts. 

Guard  submodel  DAY  TWO  includes  separate  interior  and 
exterior  patrols.  As  with  DAY_ONE  interior  and  exterior  patrols 
are  alerted  when  a  sensor  is  triggered.  Table  C.2  defines  the 
prompts  and  their  default  values. 
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Table  C. 2 

Guard  Submodel  DAY.TWO 
Prompts 


Prompt 

Size  of  Interior  Patrol 
Size  of  Exterior  Patrol 
Patrol  Weaponry 
Patrol  Proficiency 
Augmentation  Force  Weaponry 


Defualt  Value 
1 
1 

Handguns 

50% 

Handguns 


Three  prompt  query  sets  allow  selection  of  the  patrol 
prompts,  excluding  augmentation  force  weaponry;  all  prompts;  or  a 
default  set,  issuing  no  prompts. 

Guard  submodel  NGHT  ONE,  like  DAY_ONE  allows  for  only  one 
guard  force  to  patrol  both  the  interior  and  exterior.  NGHT_ONE 
varies  from  DAY_ONE  in  the  manner  patrols  are  alerted  when  a 
sensor  is  triggered.  Only  an  interior  patrol  is  alerted  by  a 
sensor  triggering.  The  prompts  and  prompt  query  set  associated 
with  NGHT_ONE  are  identical  to  those  defined  for  DAY_0NE. 

Guard  submodel  NGHT  TWO,  like  DAY_TWO  allows  for  two  guard 
forces.  It  varies  from  DAY_TWO  in  that  only  the  interior  patrol 
is  alerted  when  a  sensor  it  triggered.  The  prompts  and  prompt 
query  set  associated  with  NGHT_TWO  are  identical  to  those  defined 
for  DAY  TWO. 
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Adversary  Submodel 

The  adversary's  objective  is  to  sabotage  the  target.  Two 
adversary  submodels  have  been  defined  to  support  this  objective. 

In  both  cases  the  adversary  cuts  through  the  roof  of  the  building 
taking  a  fixed  amount  of  time  based  on  a  uniform  distribution  with 
a  minimum  of  four  minutes  and  a  maximum  of  nine  minutes.  After 
cutting  through  the  roof,  they  sabotage  the  taroet. 

Adversary  submodel  ATT  GRP  begins  with  three  adversaries 
entering  at  space  node  03  and  climbing  a  fire  escape  ladder  to  the 
roof  one  at  a  time.  The  time  that  is  required  to  cross  space  03 
is  one  minute.  The  time  that  each  adversary  takes  to  climb  the 
ladder  is  normally  distributed  with  a  mean  of  .333  minutes  and  a 
standard  deviation  of  .1  minutes.  If  guards  appear  while  they  are 
climbing  the  ladder,  they  will  engage  the  guard  force.  Table  C.3 
shows  the  prompts  and  default  values  associated  with  this 


submodel . 


Table  C.3 


Adversary  Submodel  ATT_GRD 
Prompts 


Prompt 

Adversary  Weaponry 
Adversary  Proficiency 
Time  to  Sabotage  Target 


Defualt 

Handguns 

50% 

6  minutes 


Four  prompt  query  sets  have  been  defined.  The  first, 
ATTACK,  supports  prompts  for  adversary  weaponry  and  proficiency. 
Prompt  query  set  MISSION  prompts  for  only  the  sabotage  time. 
TOTAL  issues  all  three  prompts.  DEFAULT  issues  no  prompts  and 
supplies  default  values  for  all  prompts. 

Adversary  submodel  ATT  AIR  assumes  the  adversaries  are 
attacking  the  site  from  the  air  and  do  not  need  to  climb  the 
ladder.  Hence,  they  are  immediately  placed  on  the  roof.  The 
prompts  and  prompt  query  sets  defined  for  ATT_GRD  are  also  used 
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COMPLETE  MODEL  -  EXAMPLE 


This  appendix  contains  a  complete  copy  of  the  model  that  has 
been  used  as  an  example  throughout  this  manual.  In  addition,  you 
will  find  all  of  the  master  prompt  query  databases  and  prompt 
query  set  databases.  All  of  the  information  shown  reflect  the 
default  responses  to  the  queries. 


Facility  Submodel 

Figure  D.l  shows  the  graphical  facility  submodel.  Figure 
D.2  displays  the  facility  submodel  echo  report  providing  detailed 
information  on  the  submodel. 


Figure  D.l:  Facility  Submodel 


mm 


.  •  *\  -\  V 

•  *  -  **•  •*.  \%  J  "*•  •*<.  **  ^ 


********************************************* 
*  * 

*  ECHO  CHECK  FOR  THE  FACILITY  SUBMODEL  * 

*  * 
********************************************* 


**  FACILITY  LOCATIONS  ** 


STATISTICS 


NODE 

LABEL 

COLLECTION 

OPTION 

NODE 

TYPE 

ACTIVE  / 
DISABLED 

ADJACENT  ADD 

NODES  LABELS 

D 1 

NO 

BARRIER 

ACT 

CUT 

NO 

BARRIER 

ACT 

ROOF 

NO 

SPACE 

LADR 

NO 

SPACE 

05 

NO 

SPACE 

04 

NO 

SPACE 

03 

NO 

SPACE 

S3 

02 

NO 

SPACE 

01 

NO 

SPACE 

SI 

13 

NO 

SPACE 

14 

NO 

SFACE 

15 

NO 

SPACE 

11 

NO 

SPACE 

12 

NO 

SPACE 

TAR1 

NO 

TARGET 

S2 

Figure  D.2:  Facility  Submodel  Echo  Report 


231 


3 


| 


Control  Submodel 


Figure  D.3  displays  the  echo  report  of  the  control  submodel. 
Figure  D.4  shows  the  prompt  query  set  database  for  the  control 
submodel . 


ECHO  CHECK  FOR  THE  CONTROL  SUBMODEL 


••  PARAMETER  SETS  •• 


PARAMETER 


B  BET 

D  NUMBER 

ONE 

TWO 

THREE 

FOUR 

* 

1.000 

1.300 

2.30 

•  OOO 

K  s 

.300 

.730 

1.25 

.OOO 

n  /» 

.333 

.000 

. 100E+21 

.  lOO 

K  a 

2.000 

2.300 

3.50 

.OOO 

B  9 

1.000 

1.230 

1.7S 

.OOO 

#* 

STATUS  VARIABLES 

*» 

STATUS 

VARIABLE 

INITIAL 

LABEL 

TYPE 

VALUE 

IPI 

BLOBAL  VAR. 

4.000 

OP  I 

GLOBAL  VAR. 

B.OOO 

ALRM 

REGULAR  FLAG 

DISABLED 

FI 

FORCE  FLAG 

DISABLED 

! 

** 

TIMER  CARDS  ** 

TIMER 

ALPHANUMERIC 

LABEL 

OPTION 

IDENTIFIER 

TT1 

TSM 

TIM  FRM  ALRM  TO 

••  MACRO  CARDS  •• 

MACRO  DOB 

LABEL  ACTIONS 


MAC!  SET ( IPI  ,  3.0001 

BET (OP  I  ,  9. 000) 

MAC2  MTT1  > 

AALRM  ) 


Figure  D.3:  Control  Submodel  Echo  Report 
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DEFAULT  Automatically  select  default  parameters,  if  any  e:- 1  st . 

0; 


Figure  D.4:  Control  Submodel  Prompt  Query  Set  Database 

Adversary  Detection  Submodel 

Figures  D.5  through  D.12  display  the  graphical  diagrams  for 
both  adversary  detection  submodels ,  DET1  and  DET2.  They  also  show 
the  associated  echo  reports,  prompt  query  set  databases,  and 
master  prompt  query  databases. 


********************************************** 
*  * 

*  ECHO  CHECK  FOR  THE  DETECTION  SUBMODEL  * 

*  * 
it***************************'***************** 


ADD 


**  ADVERSARY  DETECTION  DEVICES  ** 


ADD 


TEMPORARY/ 


PROBABILITY 

OF 


INFORMATION 


LABEL 

TYPE 

PERMANENT 

DETECTION 

RECE 

S3 

SENSOR 

PERM 

1 . 000 

SI 

SI 

SENSOR 

PERM 

1 . 000 

S3 

S2 

SENSOR 

PERM 

.  950 

Ml 

Ml 

MONITOR 

Ml 

Figure  D.6:  Adversary  Detection  Submodel  DET1  Echo  Report 


SENSORS  Sets  the  sensor  sped  -f  i  cat i  ons . 

1,2; 

DEFAULT  Automatically  select  de-fault  parameters,  i -f  any  exist. 

O; 


Figure  D.7:  Adversary  Detection  Submodel  DET1 
Prompt  Query  Set  Database 
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0,  "ENTER  THE  PROBABILITY  OF" ,1s 

2, "  DETECTION  FOR  SENSOR  S2?" , . 95 , . 40, 1 . 0: 

@2,1; 

0, "ENTER  THE  SIGNAL  PERSISTENCE",!; 

3, "  OF  SENSOR  S2  ?" , PER , PER , TEN; 


Figure  D.8s  Adversary  Detection  Submodel  DET1 
Master  Prompt  Query  Database 


Figure  D.9:  Adversary  Detection  Submodel  DET2 


*  ECHO  CHECK  FOR  THE  DETECTION  SUBMODEL  * 

•  * 
♦  ♦a-*******#********************************** 


**  ADVERSARY  DETECTION  DEVICES  ** 

PROBABILITY 


ADD 

LABEL 

ADD 

TYPE 

TEMPORARY/ 

PERMANENT 

OF 

DETECTION 

INFORMATION 

RECEIVER 

SI 

SENSOR 

PERM 

.950 

Ml 

S3 

SENSOR 

PERM 

.950 

Ml 

S2 

SENSOR 

PERM 

.  950 

Ml 

Ml 

MONITOR 

HI 

Figure  D.10: 

Adversary  Detection 

Submodel  DET2 

! 

Echo  Report 

SENSORS  Sets  all  sensor  spec  i  f  i  cati  ons. 

1  1  i  I  "'  1  ^  I  J  I  ^  > 

EXTER  Set  exterior  sensor  speci f i cat i ons. 

J  ^  1 5 1 6 ; 

INTER  Set  interior  sensor  specifications. 

1,2; 

DEFAULT  Automatically  select  default  parameters,  if  any  exist. 

0; 


Figure  D.lls  Adversary  Detection  Submodel  DET2 
Prompt  Query  Set  Database 


"ENTER  THE  PROBABILITY  OF", Is 
"  DETECTION  FOR  SENSOR  S2?" , . 95, . 40, 1 . O; 
1 ; 

"ENTER  THE  SIGNAL  PERSISTENCE" , 1 5 
"  OF  SENSOR  S2  ?" , PER , PER , TEN; 

1 ; 

"ENTER  THE  PROBABILITY  0F",1; 

"  DETECTION  FOR  SENSOR  SI?" , . 95, . 40, 1 . 0; 
1 5 

"ENTER  THE  SIGNAL  PERS I STENCE " , 1 ; 

"  OF  SENSOR  SI  ? " , PER , PER , TEM ; 

1 ; 

"ENTER  THE  PROBABILITY  0F",1; 

"  DETECTION  FOR  SENSOR  S3?" , . 95 , . 40 , 1 . 0; 

1 S 

"ENTER  THE  SIGNAL  PERSISTENCE",1; 

"  OF  SENSOR  S3  ,  PER  ,  PER  ,  TEM; 


Figure  D12:  Adversary  Detection  Submodel  DGT2 
Master  Prompt  Query  Database 
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ECHO  CHECK  FOR  THE  GUARD 


SUBMODEL 


*#  GUARD  ENGAGEMENT  CARD  «» 

TERMINATION  CONDITION  DEFAULT  PEBL 

SIZE.LE.  .0  FGi 


»#  GUARD  FENG  CARDS  ** 


FENG 

DENG 

LABEL 

LABEL 

TINC  VALUE 

FGI 

DG1 

1  -  00 

PG2 

DG2 

1 . 00 

••  GUARD  DENG  CARDS  •• 


DENG 

LABEL 

POSTURE 

EXFOSURE 

WHILE 

FIRING 

EXFOSURE 

WHILE 

RELOADING 

PERCENT 

TIME  SELF 

DELAY  POSTURE 

ILLUMINATION 

SUPPRES¬ 

SION 

TACTIC 

DG1 

CROUCHING 

30.0 

30.0 

.  0  . 0 

so .  o 

NO 

ASSAULT 

DG2 

STANDING 

30.0 

100.0 

.0  .0 

.  0 

NO 

ASSAULT 

**  GUARD 

BASE  NODES  *# 

NODE 

NUMBER  OF 

LABEL 

guards 

WEAPON  TYPE 

PROF  I  Cl ENCY 

B1 

5 . 

PIS  rOLS 

50 .  0 

B2 

i . 

PISTOLS 

.  0 

**  GUARD  ENTER  NODES  *• 

NODE  TIME  OF  FACILITY 

LABEL  ARRIVAL  LOCATION  MXTAt 


EG  I  .00  Dt  1 

EG2  .00  »*»*  1 


**  GUARD  ALLOCATE  NODES  ** 


NODE 

BASE 

LABEL 

LABEL 

MXTAK 

SIZE 

AL1 

B 1 

1 

2 . 

AL2 

B2 

1 

0. 

Figure  D.14a:  Guard  Submodel  DAY_ONE  Echo  Report 
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W3 
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Figure  D.14b:  Guard  Submodel  DAY_ONE  Echo  Report 
( continued ) 
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PATROL 

1,2,3| 

TOTAL 

1,2,3/ 

4s 

DEFAULT 

0% 


Sets  the  characteri sties  of  the  guard 
Sets  patrol  characteri sties  and  other 


patrol . 
parameters. 


Automati cal  1  y  select  default  parameters,  if  any 


Figure  D.15:  Guard  Submodel  DAY_ONE  Prompt  Query  Set 
Database 

@1,1; 

1,  "ENTER  SIZE  OF  GUARD  PATROL?" , 2 , 1 , 5; 

02,0; 

0,"  HG  -  HANDGUNS", 1; 

0,"  SG  -  SHOTGUNS ",1; 

0,"  SA  -  SEMIAUTOMATICS", 1; 

0,”  SM  -  SUBMACHINEGUNS" , 1; 

0,"  FA  -  FULLY  AUTOMATIC" , 1 ; 

0,"  NW  -  NO  WEAPONS" , 1 ; 

0, "ENTER  THE  TYPE  OF  WEAPONS",!; 
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0,"  NW  -  NO  WEAPONS" ,1; 

0, "ENTER  THE  TYPE  OF  WEAPONS" ,1; 

3,"  USED  BY  THE  ADVERSARY  FORCE  ? " , HG , HG , SG , SA , SM , FA , NW; 

02.1; 

2, "ENTER  THE  PROFICENCY  OF  THE  ADVERSARY  FORCE?" ,50. 0,0. O, 100. 0; 
03 , 1 ; 

2, "NOT  REALLY  A  PROMPT  QUERY  ",0.0,0.0,100.0; 

«4,l; 

0, "ENTER  THE  TASK  TIME  FOR  THE  ADVERSARY" , 1 , 

2,"  FORCE  AT  THE  TARGET  LOCATION?" , 6. 0 , 3. O , 20. 0; 

Figure  D.36:  Adversary  Submodel  ATT_AIR  Master  Prompt  Query 
Database 
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